CustomTaskPane.Height 屬性

取得或設定自訂工作窗格的高度 (以點為單位)。

命名空間：  Microsoft.Office.Tools
組件：  Microsoft.Office.Tools.Common (在 Microsoft.Office.Tools.Common.dll 中)

語法

'宣告
Property Height As Integer
    Get
    Set

int Height { get; set; }

屬性值

型別：System.Int32
自訂工作窗格的高度 (以點為單位)。

例外狀況

備註

如果自訂工作窗格停駐在文件視窗的左側或右側，請勿使用 Height 屬性。 如果 DockPosition 屬性是 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight 或 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft，則 Height 屬性會傳回　0，並在您嘗試設定時擲回 COMException。

最大高度取決於停駐位置。 將自訂工作窗格固定在文件視窗的上方或下方時，最大高度約為螢幕高度的一半。 自訂工作窗格處於浮動狀態時，沒有最大高度。

最小高度取決於幾個因素，並且可以在未來版本的 Microsoft Office 中變更。 如果嘗試將 Height 屬性設定為小於最小高度的值，應用程式將會自動將 Height 屬性重新指派為最小高度。

範例

下列程式碼範例會建立自訂工作窗格，當窗格顯示在使用中的應用程式視窗之前時，具有指定的高度。 這個程式碼範例是 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 安全性

• 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。

請參閱

參考

CustomTaskPane 介面

Microsoft.Office.Tools 命名空間