CustomTaskPane.Width Właściwość

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

Wartość właściwości

Szerokość niestandardowego okienka zadań w punktach.

Wyjątki

Przykłady

Poniższy przykład kodu tworzy niestandardowe okienko zadań, które ma inną domyślną szerokość, gdy jest wyświetlana przed aktywnym oknem aplikacji, a gdy jest zadokowana do lewej lub prawej strony okna. Ten przykład kodu jest częścią większego przykładu podanego dla CustomTaskPaneelementu .

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

Uwagi

Nie używaj właściwości, Width jeśli niestandardowe okienko zadań jest zadokowane do góry lub dolnej części okna dokumentu. DockPosition Jeśli właściwość ma wartość Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop lub Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom, Width właściwość zwraca wartość 0 i zgłasza COMException wartość , jeśli spróbujesz ją ustawić.

Maksymalna szerokość zależy od położenia doku. Gdy niestandardowe okienko zadań jest zadokowane po lewej lub prawej stronie okna dokumentu, maksymalna szerokość wynosi około połowę szerokości ekranu. Gdy okienko zadań niestandardowych jest przestawne, nie ma maksymalnej szerokości.

Minimalna szerokość zależy od kilku czynników i może ulec zmianie w przyszłych wersjach pakietu Microsoft Office. Jeśli spróbujesz ustawić Width właściwość na wartość mniejszą niż minimalna szerokość, aplikacja automatycznie przypisze Width właściwość do minimalnej szerokości.

Dotyczy