CustomTaskPaneCollection 인터페이스

아티클
08/10/2011

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

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

구문

‘선언
<GuidAttribute("c3a84bf1-e95b-4d23-952d-59e35673958e")> _
Public Interface CustomTaskPaneCollection _
    Inherits IEnumerable(Of CustomTaskPane), IEnumerable, IDisposable

[GuidAttribute("c3a84bf1-e95b-4d23-952d-59e35673958e")]
public interface CustomTaskPaneCollection : IEnumerable<CustomTaskPane>, 
    IEnumerable, IDisposable

CustomTaskPaneCollection 형식에서는 다음과 같은 멤버를 노출합니다.

속성

	이름	설명
	Count	현재 CustomTaskPaneCollection의 CustomTaskPane 개체 수를 가져옵니다.
	Item	지정된 인덱스에 있는 CustomTaskPane을 가져옵니다.

위쪽

메서드

	이름	설명
	Add(UserControl, String)	새 CustomTaskPane을 만들어 현재 CustomTaskPaneCollection에 추가합니다.사용자 지정 작업 창은 지정된 UserControl을 기반으로 하며 지정된 제목이 사용됩니다.
	Add(UserControl, String, Object)	새 CustomTaskPane을 만들어 현재 CustomTaskPaneCollection에 추가합니다.사용자 지정 작업 창은 지정된 UserControl을 기반으로 하며 지정된 제목이 사용됩니다. 이 작업 창은 지정된 응용 프로그램 창과 연결됩니다.
	BeginInit	인프라입니다.
	Dispose	관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 응용 프로그램 정의 작업을 수행합니다. (IDisposable에서 상속됨)
	EndInit	인프라입니다.
	GetEnumerator()	컬렉션을 반복하는 열거자를 반환합니다. (IEnumerable<CustomTaskPane>에서 상속됨)
	GetEnumerator()	컬렉션을 반복하는 열거자를 반환합니다. (IEnumerable에서 상속됨)
	Remove	CustomTaskPaneCollection 에서 지정된 CustomTaskPane을 제거합니다.
	RemoveAt	CustomTaskPaneCollection 의 지정된 인덱스에서 CustomTaskPane을 제거합니다.

위쪽

설명

응용 프로그램 수준 추가 기능에서 CustomTaskPaneCollection 개체를 사용하여 응용 프로그램에 사용자 지정 작업 창을 추가하거나, 사용자 지정 작업 창을 제거하거나, 기존 사용자 지정 작업 창에 액세스할 수 있습니다. CustomTaskPaneCollection 개체에 액세스하려면 프로젝트에서 ThisAddIn 클래스의 CustomTaskPanes 필드를 사용합니다. 자세한 내용은 응용 프로그램 수준 추가 기능 프로그래밍을 참조하십시오.

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

참고

이 인터페이스는 Visual Studio Tools for Office Runtime에 의해 구현되며 코드에서 직접 구현할 수는 없습니다. 자세한 내용은 Visual Studio Tools for Office 런타임 개요를 참조하십시오.

용도

이 문서에서는 .NET Framework 4를 대상으로 하는 Office 프로젝트에서 사용되는 이 형식의 버전을 설명합니다. .NET Framework 3.5를 대상으로 하는 프로젝트에서는 이 형식의 멤버가 다를 수 있으며 이 형식을 위해 제공되는 코드 예제가 작동하지 않을 수도 있습니다. .NET Framework 3.5를 대상으로 하는 프로젝트의 이 형식에 대한 문서는 Visual Studio 2008 설명서의 다음 참조 섹션을 참조하십시오. https://go.microsoft.com/fwlink/?LinkId=160658.

예제

다음 코드 예제에서는 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);
}