Właściwość CustomTaskPane.Width —

Pobiera lub ustawia szerokość niestandardowe okienko zadań, w punktach.

Przestrzeń nazw:  Microsoft.Office.Tools
Zestaw:  Microsoft.Office.Tools.Common (w Microsoft.Office.Tools.Common.dll)

Składnia

'Deklaracja
Property Width As Integer

int Width { get; set; }

Wartość właściwości

Typ: System.Int32
Szerokość niestandardowe okienko zadań, w punktach.

Wyjątki

Wyjątek	Warunek
COMException	Wartość DockPosition właściwość jest Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop lub Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom podczas próby zestaw Width właściwość. -lub- Spróbuj ustawić Width właściwość w procedurze obsługi zdarzenia dla DockPositionChanged lub VisibleChanged zdarzenia.
ObjectDisposedException	Dispose Metoda CustomTaskPane została już wywołana.

Uwagi

Nie należy używać Width właściwość, jeśli niestandardowe okienko zadań jest zadokowany na górze lub na dole okna dokumentu.Jeśli DockPosition właściwość jest Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop lub Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom, Width właściwość zwraca wartość 0 i rzuca COMException Jeśli spróbujesz ustawić go.

Maksymalna szerokość zależy od położenia dokowania.Gdy niestandardowe okienko zadań jest zadokowany do lewej lub prawej stronie okna dokumentu, maksymalna szerokość wynosi około połowy szerokości ekranu.Niestandardowe okienko zadań jest ruchomy, nie ma żadnych maksymalna szerokość.

Minimalna szerokość zależy od kilku czynników, a można zmienić w przyszłych wersjach pakietu Microsoft Office.Jeśli spróbujesz ustawić Width właściwość na wartość, która jest mniejsza niż minimalna szerokość, aplikacja automatycznie spowoduje ponowne przypisanie Width właściwość do minimalnej szerokości.

Przykłady

Poniższy przykład kodu tworzy niestandardowe okienko zadań, który ma inną domyślną szerokość, kiedy wyświetli się przed oknem aktywnej aplikacji, a gdy jest zamocowany do lewej lub prawej stronie okna.Poniższy przykład kodu jest częścią większy przykład przewidziane CustomTaskPane.

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

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);
}

Zabezpieczenia programu .NET Framework

• Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.

Zobacz też

Informacje

CustomTaskPane Interfejs

Przestrzeń nazw Microsoft.Office.Tools