CustomTaskPane.Width Özellik

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

Özel görev bölmesinin genişliğini nokta cinsinden alır veya ayarlar.

public:
 property int Width { int get(); void set(int value); };

public int Width { get; set; }

member this.Width : int with get, set

Public Property Width As Integer

Özellik Değeri

Int32

Nokta cinsinden özel görev bölmesinin genişliği.

Özel durumlar

COMException

özelliğini ayarlamaya DockPositionWidth çalıştığınızda özelliğin değeri Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop veya Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom'dur.-veya-Veya VisibleChanged için DockPositionChanged olay işleyicisinde özelliğini ayarlamaya Width çalışırsınız.

ObjectDisposedException

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

Örnekler

Aşağıdaki kod örneği, etkin uygulama penceresinin önünde görüntülendiğinde ve pencerenin sol veya sağ tarafına yerleştirildiğinde farklı bir varsayılan genişliğe sahip özel bir görev bölmesi oluşturur. 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

Özel görev bölmesi belge penceresinin Width en üstüne veya altına yerleştirilmişse özelliğini kullanmayın. DockPosition özelliği veya Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottomiseMicrosoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop, Width özelliği 0 döndürür ve ayarlamaya çalışırsanız bir COMException oluşturur.

Maksimum genişlik, takma birimi konumuna bağlıdır. Özel görev bölmesi belge penceresinin soluna veya sağına yerleştirildiğinde, maksimum genişlik ekranın genişliğinin yaklaşık yarısı olur. Özel görev bölmesi kayan olduğunda, maksimum genişlik yoktur.

Minimum genişlik çeşitli faktörlere bağlıdır ve Microsoft Office'in gelecek sürümlerinde değişebilir. Özelliği minimum genişlikten küçük bir değere ayarlamaya Width çalışırsanız, uygulama özelliği otomatik olarak minimum genişliğe yeniden atayacaktır Width .