CustomTaskPane.Height 속성 (2007 시스템)

업데이트: 2007년 11월

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

네임스페이스:  Microsoft.Office.Tools
어셈블리:  Microsoft.Office.Tools.Common.v9.0(Microsoft.Office.Tools.Common.v9.0.dll)

구문

Public Property Height As Integer

Dim instance As CustomTaskPane
Dim value As Integer

value = instance.Height

instance.Height = value

public 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됩니다.

예제

다음 코드 예제에서는 활성 응용 프로그램 창 앞에 표시될 때의 높이가 지정되어 있는 사용자 지정 작업 창을 만듭니다. 이 코드 예제는 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);
}

권한

• 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

CustomTaskPane 클래스

CustomTaskPane 멤버

Microsoft.Office.Tools 네임스페이스