CustomTaskPane.Height Ö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

Özel görev bölmesinin yüksekliğini nokta cinsinden alır veya ayarlar.

public:
 property int Height { int get(); void set(int value); };
public int Height { get; set; }
member this.Height : int with get, set
Public Property Height As Integer

Özellik Değeri

Int32

Nokta cinsinden özel görev bölmesinin yüksekliği.

Özel durumlar

COMException

özelliğini ayarlamaya DockPositionHeight çalıştığınızda özelliğin değeri Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight veya Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft'tir.-veya-özelliği veya VisibleChanged olayının Height olay işleyicisinde DockPositionChanged ayarlamaya ç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 belirtilen yüksekliğ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 Height soluna veya sağına yerleştirilmişse özelliğini kullanmayın. DockPosition özellik veya Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeftiseMicrosoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight, Height özelliği 0 döndürür ve ayarlamaya çalışırsanız bir COMException oluşturur.

Maksimum yükseklik, takma birimi konumuna bağlıdır. Özel görev bölmesi belge penceresinin üstüne veya altına yerleştirildiğinde, maksimum yükseklik ekranın yüksekliğinin yaklaşık yarısı kadardır. Özel görev bölmesi kayan olduğunda maksimum yükseklik yoktur.

Minimum yükseklik çeşitli faktörlere bağlıdır ve Microsoft Office'in gelecek sürümlerinde değişebilir. Özelliği minimum yükseklik değerinden Height küçük bir değere ayarlamaya çalışırsanız, uygulama özelliği otomatik olarak en düşük yüksekliğe yeniden atayacaktır Height .

Şunlara uygulanır