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
自訂工作窗格的高度 (以點為單位)。

例外狀況

例外狀況 條件
COMException

嘗試設定 Height 屬性時，DockPosition 屬性的值會是 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight 或 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft。

-或-

您嘗試在 DockPositionChanged 或 VisibleChanged 事件的事件處理常式中設定 Height 屬性。
ObjectDisposedException

已經呼叫過 CustomTaskPane 的 Dispose() 方法。

備註

如果自訂工作窗格停駐在文件視窗的左側或右側，請勿使用 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 命名空間