CustomTaskPane.DockPosition 속성 (2007 시스템)
업데이트: 2007년 11월
응용 프로그램 창을 기준으로 사용자 지정 작업 창이 배치되는 위치를 지정하는 값을 가져오거나 설정합니다.
네임스페이스: Microsoft.Office.Tools
어셈블리: Microsoft.Office.Tools.Common.v9.0(Microsoft.Office.Tools.Common.v9.0.dll)
구문
Public Property DockPosition As MsoCTPDockPosition
Dim instance As CustomTaskPane
Dim value As MsoCTPDockPosition
value = instance.DockPosition
instance.DockPosition = value
public 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);
}
권한
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.