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	DockPosition 속성이 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight 또는 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft인 상태에서 Height 속성을 설정하려고 한 경우 또는 DockPositionChanged 또는 VisibleChanged 이벤트에 대한 이벤트 처리기에서 Height 속성을 설정하려고 한 경우
ObjectDisposedException	CustomTaskPane의 Dispose() 메서드가 이미 호출된 경우

설명

사용자 지정 작업 창이 문서 창의 왼쪽이나 오른쪽에 도킹되어 있는 경우에는 Height 속성을 사용하지 마십시오. DockPosition 속성이 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight 또는 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft인 경우 이 속성을 설정하려고 하면 Height 속성에서 0이 반환되고 COMException이 throw됩니다.

최대 높이는 도킹 위치에 따라 달라집니다. 사용자 지정 작업 창이 문서 창의 상단이나 하단에 도킹되어 있는 경우 최대 높이는 대략 화면 높이의 절반입니다. 사용자 지정 작업창이 부동일 때 최대 높이는 없습니다.

최소 높이는 여러 가지 요인에 따라 달라지며 향후 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 네임스페이스