CustomTaskPane.DockPosition – vlastnost

Článek
08/11/2011

Získá nebo nastaví hodnotu, která určuje, kde je umístěn vzhledem kokno aplikace úlohapodokno .

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

Syntaxe

'Deklarace
Property DockPosition As MsoCTPDockPosition
    Get
    Set

MsoCTPDockPosition DockPosition { get; set; }

Hodnota vlastnosti

Typ: Microsoft.Office.Core.MsoCTPDockPosition
Jeden z Microsoft.Office.Core.MsoCTPDockPosition hodnoty.Výchozí hodnota 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- Zkuste obslužnou rutinu událost pro tuto vlastnost nastavit DockPositionChanged nebo VisibleChangedudálost.

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-

Zkuste obslužnou rutinu událost pro tuto vlastnost nastavit DockPositionChanged nebo VisibleChangedudálost.

Poznámky

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

Hodnota	Popis
msoCTPDockPositionLeft	úlohavlastnípodokno ukotvené na levé straně okno.
msoCTPDockPositionTop	úlohavlastnípodokno ukotvené do horní části okno.
msoCTPDockPositionRight	úlohavlastnípodokno ukotvené na pravé straně okno.
msoCTPDockPositionBottom	úlohavlastnípodokno ukotvené do spodní části okno.
msoCTPDockPositionFloating	Zobrazuje vlastní úloha podokno z okno. uživatel můžete přetáhnout na libovolné místo v okno úlohapodokno .

Příklady

Následující příklad kódu vytvoří vlastní úlohapodokno a konfiguruje jiný výchozí velikost zobrazí v podokno z aplikaceaktivníoknoa je ukotven. Příklad kódu je součástí větší příklad k 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é

Odkaz

CustomTaskPane Rozhraní

Microsoft.Office.Tools – obor názvů

Sdílet prostřednictvím