다음을 통해 공유

CustomTaskPane.DockPosition 속성

  • 아티클

응용 프로그램 창을 기준으로 사용자 지정 작업 창이 배치되는 위치를 지정하는 값을 가져오거나 설정합니다.

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

구문

‘선언
Property DockPosition As MsoCTPDockPosition
    Get
    Set

MsoCTPDockPosition DockPosition { get; set; }

속성 값

형식: Microsoft.Office.Core.MsoCTPDockPosition
Microsoft.Office.Core.MsoCTPDockPosition 값 중 하나입니다.기본값은 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight입니다.

예외

예외 상황
ObjectDisposedException

CustomTaskPane의 Dispose() 메서드가 이미 호출된 경우
COMException

DockPositionRestrict 속성의 값이 Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRestrictNoChange인 상태에서 DockPosition 속성의 값을 변경하려고 한 경우

또는

DockPositionChanged 또는 VisibleChanged 이벤트에 대한 이벤트 처리기에서 이 속성을 설정하려고 한 경우

설명

다음 표에서는 Microsoft.Office.Core.MsoCTPDockPosition 열거형의 값을 보여 줍니다.

값

설명

msoCTPDockPositionLeft

사용자 지정 작업 창을 응용 프로그램 창의 왼쪽에 도킹합니다.

msoCTPDockPositionTop

사용자 지정 작업 창을 응용 프로그램 창의 위쪽에 도킹합니다.

msoCTPDockPositionRight

사용자 지정 작업 창을 응용 프로그램 창의 오른쪽에 도킹합니다.

msoCTPDockPositionBottom

사용자 지정 작업 창을 응용 프로그램 창의 아래쪽에 도킹합니다.

msoCTPDockPositionFloating

사용자 지정 작업 창을 응용 프로그램 창 앞에 표시합니다. 사용자는 작업 창을 응용 프로그램 창에서 임의의 위치에 끌어 놓을 수 있습니다.

예제

다음 코드 예제에서는 사용자 지정 작업 창을 만들고 창이 활성 응용 프로그램 창 앞에 표시될 때와 창이 도킹될 때의 기본 크기를 다르게 구성합니다. 이 코드 예제는 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 네임스페이스