Aracılığıyla paylaş


CustomTaskPane.Height Özellik

Alır veya noktalar özel görev bölmesinin yüksekliğini ayarlar.

Ad alanı:  Microsoft.Office.Tools
Derleme:  Microsoft.Office.Tools.Common (Microsoft.Office.Tools.Common.dll içinde)

Sözdizimi

'Bildirim
Property Height As Integer
int Height { get; set; }

Özellik Değeri

Tür: System.Int32
Özel görev bölmesi, punto cinsinden yüksekliği.

Özel Durumlar

Exception Koşul
COMException

Değeri DockPosition özelliği Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight veya Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft ayarlamaya çalıştığınızda Height özelliği.

-veya-

Ayarlamaya çalıştığınızda Height için olay işleyicisi özelliğinde DockPositionChanged veya VisibleChanged olay.

ObjectDisposedException

Dispose Yöntemi, CustomTaskPane zaten çağrıldı.

Notlar

Kullanmayın Height özel görev bölmesi, belge penceresinin sağa veya sola yerleştirilmişse özelliği.Yoksa DockPosition özelliği Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight veya Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft, Height özelliği 0 döndürür ve atan bir COMException ayarlamaya çalışırsanız.

Maksimum yükseklik stok konumuna bağlıdır.Özel görev bölmesinin üst veya belge penceresinin altındaki yerleştirildiğinde, en fazla yaklaşık yarım ekran yüksekliğini yüksekliğidir.Özel görev bölmesini Yüzen olduğunda hiçbir en fazla yüksekliği.

Minimum yükseklik birçok etmene bağlıdır ve Microsoft Office sürümlerinde gelecekte değiştirebilirsiniz.Ayarlamaya çalışırsanız Height özelliği en küçük yüksekliği daha küçük bir değere uygulama atama otomatik olarak Height yüksekliği en az özelliğe.

Örnekler

Aşağıdaki kod örneği, ne zaman etkin uygulama penceresinin belirtilen yüksekliği olan bir özel görev bölmesini oluşturur.Bu kod örneği için sağlanan daha büyük bir örneğin parçasıdır CustomTaskPane.

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
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);
}

.NET Framework Güvenliği

Ayrıca bkz.

Başvuru

CustomTaskPane Arabirim

Microsoft.Office.Tools Ad Alanı