CustomTaskPane.Height 속성

정의

네임스페이스:

Microsoft.Office.Tools

어셈블리:

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

사용자 지정 작업 창의 높이를 포인트 단위로 가져오거나 설정합니다.

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

속성 값

Int32

사용자 지정 작업 창의 포인트 단위 높이입니다.

예외

COMException

속성을 설정 Height 하려고 할 때 속성 값 DockPosition 은 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight 또는 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft입니다. 또는 또는 이벤트에 대한 VisibleChangedDockPositionChanged 이벤트 처리기에서 속성을 설정 Height 하려고 합니다.

ObjectDisposedException

CustomTaskPane의 Microsoft.Office.Tools.CustomTaskPane.Dispose 메서드가 이미 호출되었습니다.

예제

다음은 현재 애플리케이션 창 앞에 표시되는 높이가 지정된 사용자 지정 작업창을 만드는 코드 예제입니다. 이 코드 예제는 에 CustomTaskPane제공된 더 큰 예제의 일부입니다.

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

설명

사용자 지정 작업창이 Height 문서 창의 왼쪽 또는 오른쪽에 도킹된 경우 속성을 사용하지 마세요. 속성이 DockPosition 또는 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft이면 속성은 HeightMicrosoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight 0을 반환하고 설정하려고 하면 을 throw합니다COMException.

최대 높이는 도크 위치에 따라 달라집니다. 사용자 지정 작업창이 문서 창의 위쪽 또는 아래쪽에 도킹되면 최대 높이는 화면 높이의 약 절반입니다. 사용자 지정 작업창이 부동일 때 최대 높이가 없습니다.

최소 높이는 몇 가지 요인에 따라 달라지며 Microsoft Office의 향후 릴리스에서 변경될 수 있습니다. 속성을 최소 높이보다 작은 값으로 설정 Height 하려고 하면 애플리케이션에서 자동으로 속성을 최소 높이로 다시 할당 Height 합니다.