CustomTaskPane.DockPosition Özellik

Başvuru

Tanım

Ad Alanı:: Microsoft.Office.Tools

Bütünleştirilmiş Kodlar:: 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

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

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

Özellik Değeri

MsoCTPDockPosition

Microsoft.Office.Core.MsoCTPDockPosition değerlerinden biri. Varsayılan değer Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight'tır.

Özel durumlar

ObjectDisposedException

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

COMException

özelliğinin DockPositionRestrict değerini değiştirmeye DockPosition çalıştığınızda özelliğin değeri Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRestrictNoChange'tir.-veya-Bu özelliği veya VisibleChanged olayının olay işleyicisinde DockPositionChanged ayarlamaya çalışırsınız.

Örnekler

Aşağıdaki kod örneği özel bir görev bölmesi oluşturur ve bölmenin etkin uygulama penceresinin önünde görüntülendiği ve yerleştirildiğinde için farklı varsayılan boyutları yapılandırmaktadır. Bu kod örneği için CustomTaskPanesağlanan daha büyük bir örneğin parçasıdır.

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 tabloda sabit listesinin Microsoft.Office.Core.MsoCTPDockPosition değerleri listelemektedir.

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

Şunlara uygulanır