CustomTaskPane.DockPosition Vlastnost

Reference

Definice

Obor názvů:: Microsoft.Office.Tools

Sestavení:: 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

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví hodnotu, která určuje, kde se vlastní podokno úloh nachází vzhledem k oknům aplikace.

public:
 property Microsoft::Office::Core::MsoCTPDockPosition DockPosition { Microsoft::Office::Core::MsoCTPDockPosition get(); void set(Microsoft::Office::Core::MsoCTPDockPosition value); };

public Microsoft.Office.Core.MsoCTPDockPosition DockPosition { get; set; }

member this.DockPosition : Microsoft.Office.Core.MsoCTPDockPosition with get, set

Public Property DockPosition As MsoCTPDockPosition

Hodnota vlastnosti

MsoCTPDockPosition

Jedna z Microsoft.Office.Core.MsoCTPDockPosition hodnot. Výchozí hodnota je Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight.

Výjimky

ObjectDisposedException

Metoda Microsoft.Office.Tools.CustomTaskPane.Dispose již CustomTaskPane byla volána.

COMException

Hodnota DockPositionRestrict vlastnosti je Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRestrictNoChange při pokusu DockPosition o změnu hodnoty vlastnosti.-or-Pokusíte se nastavit tuto vlastnost v obslužné rutině události nebo DockPositionChanged VisibleChanged události.

Příklady

Následující příklad kódu vytvoří vlastní podokno úloh a nakonfiguruje různé výchozí velikosti pro, když se podokno zobrazí před aktivním oknem aplikace a kdy je ukotveno. Tento příklad kódu je součástí většího příkladu pro CustomTaskPane.

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

Poznámky

Následující tabulka uvádí hodnoty výčtu Microsoft.Office.Core.MsoCTPDockPosition .

Hodnota	Popis
`msoCTPDockPositionLeft`	Ukotví vlastní podokno úloh k levé straně okna.
`msoCTPDockPositionTop`	Ukotví vlastní podokno úloh k horní části okna.
`msoCTPDockPositionRight`	Ukotví vlastní podokno úloh k pravé straně okna.
`msoCTPDockPositionBottom`	Ukotví vlastní podokno úloh v dolní části okna.
`msoCTPDockPositionFloating`	Zobrazí vlastní podokno úloh před oknem. Uživatel může podokno úloh přetáhnout na libovolné místo v okně.

Platí pro

Sdílet prostřednictvím