CustomTaskPane.DockPosition Özellik

Tanım

Özel görev bölmesinin uygulama penceresine göre nerede bulunduğunu belirten bir değer alır veya ayarlar.

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

Özellik Değeri

MsoCTPDockPosition

Microsoft. Office. Core. MsoCTPDockPosition değerlerinden biri. Varsayılan olarak Microsoft. Office. Core. MsoCTPDockPosition. msoCTPDockPositionRight.

Özel durumlar

Microsoft.Office.Tools.CustomTaskPane.DisposeÖğesinin yöntemi CustomTaskPane zaten çağrıldı.

Özelliğin değerini DockPositionRestrict değiştirmeye çalıştığınızda, özelliğinin değeri Microsoft. Office. Core. MsoCTPDockPosition. msoCTPDockPositionRestrictNoChange ' dir DockPosition .

-veya- Bu özelliği, veya olayı için olay işleyicisinde ayarlamaya çalışırsınız DockPositionChanged VisibleChanged .

Örnekler

Aşağıdaki kod örneği, özel bir görev bölmesi oluşturur ve bölmenin etkin uygulama penceresinin önünde ve yuvalandığında gösterdiği zaman için farklı varsayılan boyutlar yapılandırır. Bu kod örneği, için sağlanmış daha büyük bir örneğin bir parçasıdır 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

Açıklamalar

Aşağıdaki tablo, numaralandırmanın değerlerini listelemektedir Microsoft.Office.Core.MsoCTPDockPosition .

Değer Açıklama
msoCTPDockPositionLeft Özel görev bölmesini pencerenin sol tarafına göre noktaları.
msoCTPDockPositionTop Özel görev bölmesini pencerenin en üstüne göre noktaları.
msoCTPDockPositionRight Özel görev bölmesini pencerenin sağ tarafına noktaları.
msoCTPDockPositionBottom Özel görev bölmesini pencerenin alt kısmına göre noktaları.
msoCTPDockPositionFloating Pencerenin önünde özel görev bölmesini görüntüler. Kullanıcı görev bölmesini pencerede herhangi bir konuma sürükleyebilir.

Şunlara uygulanır