Metodo CustomTaskPaneCollection.Add (UserControl, String, Object)

Articolo
08/11/2011

Crea un nuovo oggetto CustomTaskPane e lo aggiunge alla classe CustomTaskPaneCollection corrente. Il riquadro attività personalizzato è basato sulla classe UserControl specificata, ha il titolo specificato ed è associato alla finestra dell'applicazione specificata.

Spazio dei nomi: Microsoft.Office.Tools
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Sintassi

'Dichiarazione
Function Add ( _
    control As UserControl, _
    title As String, _
    window As Object _
) As CustomTaskPane

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

Parametri

control
Tipo: System.Windows.Forms.UserControl
Classe UserControl che fornisce l'interfaccia utente per il nuovo riquadro attività personalizzato.

title
Tipo: System.String
Testo visualizzato nella barra del titolo del nuovo riquadro personalizzato.

window
Tipo: System.Object
Oggetto che rappresenta la finestra dell'applicazione da associare al nuovo riquadro attività personalizzato.

Valore restituito

Tipo: Microsoft.Office.Tools.CustomTaskPane
Oggetto CustomTaskPane che rappresenta il nuovo riquadro attività personalizzato.

Eccezioni

Eccezione	Condizione
ArgumentNullException	control o title è nullriferimento null (Nothing in Visual Basic).
ObjectDisposedException	Il metodo Dispose() è già stato chiamato nella classe CustomTaskPaneCollection.

Note

Utilizzare questo metodo per creare un nuovo oggetto CustomTaskPane associato a una finestra dell'applicazione specifica. Questo metodo è utile se si desidera creare riquadri attività personalizzati visibili con più Controlli o Finestre di esplorazione in Outlook o con più documenti in Word o InfoPath. Per ulteriori informazioni, vedere Gestione dei riquadri attività personalizzati in più finestre dell'applicazione.

Il tipo di parametro window dipende dall'applicazione. Nella tabella seguente sono inclusi i tipi validi per il parametro window.

Applicazione	Tipo parametro
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 In alternativa Microsoft.Office.Interop.Outlook.Inspector

Benché CustomTaskPaneCollection sia un insieme di oggetti CustomTaskPane, il metodo Add accetta oggetti UserControl anziché oggetti CustomTaskPane. Per ulteriori informazioni, vedere Cenni preliminari sui riquadri attività personalizzati.

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.