CustomTaskPane.DockPosition – vlastnost

Článek
01/03/2014

Získá nebo nastaví hodnotu, která určuje, kde je umístěn vzhledem k okna aplikace vlastní podokno úloh.

Obor názvů: Microsoft.Office.Tools
Sestavení: Microsoft.Office.Tools.Common (v Microsoft.Office.Tools.Common.dll)

Syntaxe

'Deklarace
Property DockPosition As MsoCTPDockPosition

MsoCTPDockPosition DockPosition { get; set; }

Hodnota vlastnosti

Typ: Microsoft.Office.Core.MsoCTPDockPosition
Jedna z hodnot Microsoft.Office.Core.MsoCTPDockPositionVýchozí je Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight.

Výjimky

Výjimka	Podmínka
ObjectDisposedException	Dispose Metoda CustomTaskPane již byla volána.
COMException	Hodnota DockPositionRestrict vlastnost je Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRestrictNoChange při pokusu změnit hodnotu DockPosition vlastnost. -nebo- Pokusíte se nastavit tuto vlastnost v obslužné rutině události DockPositionChanged nebo VisibleChanged události.

ObjectDisposedException

Dispose Metoda CustomTaskPane již byla volána.

COMException

Hodnota DockPositionRestrict vlastnost je Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRestrictNoChange při pokusu změnit hodnotu DockPosition vlastnost.

-nebo-

Pokusíte se nastavit tuto vlastnost v obslužné rutině události DockPositionChanged nebo VisibleChanged události.

Poznámky

V následující tabulce jsou uvedeny hodnoty Microsoft.Office.Core.MsoCTPDockPosition výčtu.

Value	Description
msoCTPDockPositionLeft	Vlastní podokno úloh ukotvené na levé straně okna.
msoCTPDockPositionTop	Vlastní podokno úloh ukotvené do horní části okna.
msoCTPDockPositionRight	Vlastní podokno úloh ukotvené v pravé části okna.
msoCTPDockPositionBottom	Vlastní podokno úloh ukotvené do dolní části okna.
msoCTPDockPositionFloating	Zobrazí podokno úloh vlastní před okna.Podokno úloh může uživatel přetahovat na libovolné místo v okně.

Příklady

Následující příklad kódu vytvoří vlastní podokno úloh a konfiguruje jiný výchozí velikosti podokna se zobrazí před okna aktivní aplikace a je ukotven.Tento příklad kódu je součástí většího příkladu určeného pro 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);
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

CustomTaskPane Rozhraní

Microsoft.Office.Tools – obor názvů

Sdílet prostřednictvím