CustomTaskPaneCollection.Add 메서드 (UserControl, String, Object)

아티클
08/10/2011

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

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

구문

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

CustomTaskPane Add(
    UserControl control,
    string title,
    Object window
)

매개 변수

control
형식: System.Windows.Forms.UserControl
새 사용자 지정 작업 창에 대한 사용자 인터페이스를 제공하는 UserControl입니다.

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

window
형식: System.Object
새 사용자 지정 작업 창과 연결할 응용 프로그램 창을 나타내는 개체입니다.

반환 값

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

예외

예외	상황
ArgumentNullException	control 또는 title가 nullNull 참조(Visual Basic의 경우 Nothing)인 경우
ObjectDisposedException	CustomTaskPaneCollection을 대상으로 이미 Dispose() 메서드를 호출한 경우

설명

이 메서드를 사용하면 특정 응용 프로그램 창과 연결된 새 CustomTaskPane을 만들 수 있습니다. 이 메서드는 Outlook에서 여러 개의 검사기 또는 탐색기와 함께 표시되거나 Word 또는 InfoPath에서 여러 문서와 함께 표시되는 사용자 지정 작업 창을 만들려는 경우에 유용합니다. 자세한 내용은 여러 응용 프로그램 창의 사용자 지정 작업 창 관리을 참조하십시오.

window 매개 변수의 형식은 응용 프로그램에 따라 다릅니다. 다음 표에서는 window 매개 변수의 유효한 형식을 보여 줍니다.

응용 프로그램	매개 변수 형식
Word	Microsoft.Office.Interop.Word.Window
Excel	Microsoft.Office.Interop.Excel.Window
PowerPoint	Microsoft.Office.Interop.PowerPoint.DocumentWindow
InfoPath	Microsoft.Office.Interop.InfoPath.WindowObject
Outlook	Microsoft.Office.Interop.Outlook.Explorer 또는 Microsoft.Office.Interop.Outlook.Inspector