Właściwość CustomTaskPane.DockPosition —

Pobiera lub ustawia wartość, która określa lokalizację niestandardowe okienko zadań względem okna aplikacji.

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

Składnia

'Deklaracja
Property DockPosition As MsoCTPDockPosition

MsoCTPDockPosition DockPosition { get; set; }

Wartość właściwości

Typ: Microsoft.Office.Core.MsoCTPDockPosition
Jednym z Microsoft.Office.Core.MsoCTPDockPosition wartości.Wartość domyślna to Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight.

Wyjątki

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

Uwagi

Poniższa tabela zawiera listę wartości Microsoft.Office.Core.MsoCTPDockPosition wyliczenie.

Wartość	Opis
msoCTPDockPositionLeft	Niestandardowe okienko zadań jest dokowane do lewej strony okna.
msoCTPDockPositionTop	Niestandardowe okienko zadań jest dokowane do górnej części okna.
msoCTPDockPositionRight	Niestandardowe okienko zadań jest dokowane do prawej części okna.
msoCTPDockPositionBottom	Niestandardowe okienko zadań jest dokowane do dolnej części okna.
msoCTPDockPositionFloating	Wyświetla niestandardowe okienko zadań przed oknem.Użytkownik może przeciągać okienko zadań w dowolne miejsce w oknie.

Przykłady

Poniższy przykład kodu tworzy niestandardowe okienko zadań i konfiguruje różne domyślne rozmiary, gdy w okienku są wyświetlane przed oknem aktywnej aplikacji, a kiedy jest zadokowany.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