CustomTaskPane.Width Vlastnost

Reference

Definice

Obor názvů:: Microsoft.Office.Tools

Sestavení:: Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll, Microsoft.Office.Tools.Outlook.v4.0.Utilities.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví šířku vlastního podokna úloh v bodech.

public:
 property int Width { int get(); void set(int value); };

public int Width { get; set; }

member this.Width : int with get, set

Public Property Width As Integer

Hodnota vlastnosti

Int32

Šířka vlastního podokna úloh v bodech

Výjimky

COMException

Hodnota DockPosition vlastnosti je Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop nebo Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom při pokusu Width o nastavení vlastnosti.-or-Pokusíte se nastavit Width vlastnost v obslužné rutině DockPositionChanged události nebo VisibleChanged události.

ObjectDisposedException

Metoda Microsoft.Office.Tools.CustomTaskPane.DisposeCustomTaskPane již byla volána.

Příklady

Následující příklad kódu vytvoří vlastní podokno úloh, které má jinou výchozí šířku, když se zobrazí před aktivním oknem aplikace a když je ukotveno na levé nebo pravé straně okna. Tento příklad kódu je součástí většího příkladu pro CustomTaskPane.

private MyUserControl myUserControl1;
private Microsoft.Office.Tools.CustomTaskPane myCustomTaskPane;

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    myUserControl1 = new MyUserControl();
    myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1,
        "New Task Pane");

    myCustomTaskPane.DockPosition =
        Office.MsoCTPDockPosition.msoCTPDockPositionFloating;
    myCustomTaskPane.Height = 500;
    myCustomTaskPane.Width = 500;

    myCustomTaskPane.DockPosition =
        Office.MsoCTPDockPosition.msoCTPDockPositionRight;
    myCustomTaskPane.Width = 300;

    myCustomTaskPane.Visible = true;
    myCustomTaskPane.DockPositionChanged +=
        new EventHandler(myCustomTaskPane_DockPositionChanged);
}

Private myUserControl1 As MyUserControl
Private WithEvents myCustomTaskPane As Microsoft.Office.Tools.CustomTaskPane

Private Sub ThisAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Startup

    myUserControl1 = New MyUserControl()
    myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl1, "New Task Pane")

    With myCustomTaskPane
        .DockPosition = Office.MsoCTPDockPosition.msoCTPDockPositionFloating
        .Height = 500
        .Width = 500
        .DockPosition = Office.MsoCTPDockPosition.msoCTPDockPositionRight
        .Width = 300
        .Visible = True
    End With
End Sub

Poznámky

Vlastnost nepoužívejte, Width pokud je vlastní podokno úloh ukotvené v horní nebo dolní části okna dokumentu. DockPosition Pokud je Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop vlastnost nebo Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom, Width vrátí vlastnost hodnotu 0 a při pokusu COMException o nastavení vyvolá hodnotu .

Maximální šířka závisí na poloze doku. Když je vlastní podokno úloh ukotvené nalevo nebo vpravo od okna dokumentu, maximální šířka je přibližně polovina šířky obrazovky. Pokud je vlastní podokno úloh plovoucí, neexistuje žádná maximální šířka.

Minimální šířka závisí na několika faktorech a v budoucích verzích Microsoft Office se může změnit. Pokud se pokusíte nastavit Width vlastnost na hodnotu, která je menší než minimální šířka, aplikace automaticky znovu přiřazuje Width vlastnost na minimální šířku.

Platí pro

Sdílet prostřednictvím