CustomTaskPane.Width 속성 (2007 시스템)

업데이트: 2007년 11월

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

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

구문

Public Property Width As Integer

Dim instance As CustomTaskPane
Dim value As Integer

value = instance.Width

instance.Width = value

public int Width { get; set; }

속성 값

형식: System.Int32

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

예외

예외	상황
COMException	DockPosition 속성이 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop 또는 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom인 상태에서 Width 속성을 설정하려고 한 경우 -또는- DockPositionChanged 또는 VisibleChanged 이벤트에 대한 이벤트 처리기에서 Width 속성을 설정하려고 한 경우
ObjectDisposedException	CustomTaskPane의 Dispose 메서드가 이미 호출된 경우

설명

사용자 지정 작업 창이 문서 창의 위쪽이나 아래쪽에 도킹되어 있는 경우에는 Width 속성을 사용하지 마십시오. DockPosition 속성이 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop 또는 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom인 경우 이 속성을 설정하려고 하면 Width 속성에서 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 네임스페이스