다음을 통해 공유

CustomTaskPaneCollection.Add 메서드 (UserControl, String)

  • 아티클

새 CustomTaskPane을 만들어 현재 CustomTaskPaneCollection에 추가합니다. 사용자 지정 작업 창은 지정된 UserControl을 기반으로 하며 지정된 제목이 사용됩니다.

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

구문

‘선언
Function Add ( _
    control As UserControl, _
    title As String _
) As CustomTaskPane

CustomTaskPane Add(
    UserControl control,
    string title
)

매개 변수

  • title
    형식: System.String
    새 사용자 지정 작업 창의 제목 표시줄에 나타나는 텍스트입니다.

반환 값

형식: Microsoft.Office.Tools.CustomTaskPane
새 사용자 지정 작업 창을 나타내는 CustomTaskPane입니다.

예외

예외 상황
ArgumentNullException

control 또는 title가 nullNull 참조(Visual Basic의 경우 Nothing)인 경우
ObjectDisposedException

CustomTaskPaneCollection을 대상으로 이미 Dispose() 메서드를 호출한 경우

설명

이 메서드를 사용하면 Microsoft Office 응용 프로그램의 활성 창과 연결된 새 CustomTaskPane을 만들 수 있습니다.

CustomTaskPaneCollection 개체는 CustomTaskPane 개체의 컬렉션이지만 Add 메서드에 CustomTaskPane 개체 대신 UserControl 개체를 사용할 수 있습니다. 자세한 내용은 사용자 지정 작업 창 개요을 참조하십시오.

특정 창을 지정하여 사용자 지정 작업 창과 연결하려면 Add(UserControl, String, Object) 메서드를 사용합니다.

예제

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

.NET Framework 보안

  • 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

CustomTaskPaneCollection 인터페이스

Add 오버로드

Microsoft.Office.Tools 네임스페이스