CustomTaskPane.Width 속성

정의

네임스페이스:

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 Width { int get(); void set(int value); };

public int Width { get; set; }

member this.Width : int with get, set

Public Property Width As Integer

속성 값

Int32

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

예외

COMException

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

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

설명

사용자 지정 작업창이 Width 문서 창의 위쪽 또는 아래쪽에 도킹된 경우 속성을 사용하지 마세요. 속성이 DockPosition 또는 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom이면 속성은 WidthMicrosoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop 0을 반환하고 설정하려고 하면 을 COMException throw합니다.

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

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