CustomTaskPaneCollection 클래스(2007 시스템)

아티클
08/22/2008

업데이트: 2007년 11월

Microsoft Office 응용 프로그램의 사용자 지정 작업 창 컬렉션을 나타냅니다.

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

구문

Public NotInheritable Class CustomTaskPaneCollection _
    Implements IEnumerable(Of CustomTaskPane), IEnumerable,  _
    ISupportInitialize, IDisposable

Dim instance As CustomTaskPaneCollection

public sealed class CustomTaskPaneCollection : IEnumerable<CustomTaskPane>, 
    IEnumerable, ISupportInitialize, IDisposable

설명

응용 프로그램 수준 추가 기능에서 CustomTaskPaneCollection 클래스를 사용하여 응용 프로그램에 사용자 지정 작업 창을 추가하거나, 사용자 지정 작업 창을 제거하거나, 기존 사용자 지정 작업 창에 액세스할 수 있습니다.

CustomTaskPaneCollection 클래스의 인스턴스를 직접 만들지 마십시오. 대신 추가 기능 프로젝트에서 ThisAddIn 클래스의 CustomTaskPanes 필드를 사용해야 합니다. ThisAddIn 클래스에 대한 자세한 내용은 응용 프로그램 수준 추가 기능 프로그래밍 및 추가 기능 호스트 항목을 참조하십시오.

작업 창은 일반적으로 응용 프로그램 창의 한 쪽에 도킹되는 사용자 인터페이스 패널입니다. 사용자 지정 작업 창을 만드는 방법에 대한 자세한 내용은 사용자 지정 작업 창 개요를 참조하십시오.

예제

다음 코드 예제에서는 Add(UserControl, String) 메서드를 사용하여 사용자 지정 작업 창을 만드는 방법을 보여 줍니다. 또한 이 예제에서는 CustomTaskPane 개체의 속성을 사용하여 사용자 지정 작업 창의 기본 모양을 수정합니다. 이 코드 예제는 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);
}