CustomTaskPane.Width Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Office.Tools

Zestawy:: 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

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia szerokość niestandardowego okienka zadań w punktach.

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

Int32

Szerokość niestandardowego okienka zadań w punktach.

Wyjątki

COMException

Wartość właściwości to Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop lub Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom podczas próby ustawienia Width właściwości.-or-Próbujesz ustawić Width właściwość w procedurze obsługi zdarzeń dla DockPositionChanged zdarzenia lubVisibleChanged.DockPosition

ObjectDisposedException

CustomTaskPane Metoda Microsoft.Office.Tools.CustomTaskPane.Dispose metody została już wywołana.

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

Udostępnij za pośrednictwem