Interfaccia ControlCollection

Rappresenta una raccolta di controlli gestiti in un documento di Word che è stato personalizzato tramite gli Strumenti di sviluppo di Microsoft Office per Visual Studio.

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

Sintassi

'Dichiarazione
<GuidAttribute("E1180F09-B903-4D03-8D30-2845219AEE2C")> _
Public Interface ControlCollection _
    Inherits IEnumerable
[GuidAttribute("E1180F09-B903-4D03-8D30-2845219AEE2C")]
public interface ControlCollection : IEnumerable

Il tipo ControlCollection espone i seguenti membri.

Proprietà

  Nome Descrizione
Proprietà pubblica Capacity Ottiene o imposta il numero di controlli che l'oggetto ControlCollection può contenere.
Proprietà pubblica Count Ottiene il numero di controlli inclusi in ControlCollection.
Proprietà pubblica Item[Int32] Ottiene il controllo in corrispondenza dell'indice specificato.
Proprietà pubblica Item[Object] Ottiene il controllo specificato.
Proprietà pubblica Item[String] Ottiene il controllo con il nome specificato.

In alto

Metodi

  Nome Descrizione
Metodo pubblico AddBookmark(Bookmark, String) Aggiunge un nuovo controllo Microsoft.Office.Tools.Word.Bookmark al documento nella posizione dell'oggetto esistente Microsoft.Office.Interop.Word.Bookmark specificato.
Metodo pubblico AddBookmark(Range, String) Aggiunge un nuovo controllo Bookmark al documento in corrispondenza dell'intervallo specificato.
Metodo pubblico AddBuildingBlockGalleryContentControl(String) Aggiunge un nuovo oggetto BuildingBlockGalleryContentControl in corrispondenza della selezione corrente nel documento.
Metodo pubblico AddBuildingBlockGalleryContentControl(ContentControl, String) Aggiunge un nuovo BuildingBlockGalleryContentControl all'insieme.Il nuovo controllo si basa su un controllo contenuto nativo già presente nel documento.
Metodo pubblico AddBuildingBlockGalleryContentControl(Range, String) Aggiunge un nuovo oggetto BuildingBlockGalleryContentControl in corrispondenza dell'intervallo specificato nel documento.
Metodo pubblico AddComboBoxContentControl(String) Aggiunge un nuovo oggetto ComboBoxContentControl in corrispondenza della selezione corrente nel documento.
Metodo pubblico AddComboBoxContentControl(ContentControl, String) Aggiunge un nuovo ComboBoxContentControl all'insieme.Il nuovo controllo si basa su un controllo contenuto nativo già presente nel documento.
Metodo pubblico AddComboBoxContentControl(Range, String) Aggiunge un nuovo oggetto ComboBoxContentControl in corrispondenza dell'intervallo specificato nel documento.
Metodo pubblico AddContentControl(ContentControl, String) Aggiunge un nuovo oggetto ContentControl basato su un controllo del contenuto nativo presente nel documento.
Metodo pubblico AddContentControl(String, WdContentControlType) Aggiunge un nuovo oggetto ContentControl del tipo specificato in corrispondenza della selezione corrente nel documento.
Metodo pubblico AddContentControl(Range, String, WdContentControlType) Aggiunge un nuovo oggetto ContentControl del tipo specificato in corrispondenza dell'intervallo specificato nel documento.
Metodo pubblico AddControl(Control, Range, Single, Single, String) Aggiunge il controllo specificato all'oggetto ControlCollection nell'intervallo e con le dimensioni specificate.
Metodo pubblico AddControl(Control, Single, Single, Single, Single, String) Aggiunge il controllo specificato all'oggetto ControlCollection nella posizione e con le dimensioni specificate.
Metodo pubblico AddDatePickerContentControl(String) Aggiunge un nuovo oggetto DatePickerContentControl in corrispondenza della selezione corrente nel documento.
Metodo pubblico AddDatePickerContentControl(ContentControl, String) Aggiunge un nuovo DatePickerContentControl all'insieme.Il nuovo controllo si basa su un controllo contenuto nativo già presente nel documento.
Metodo pubblico AddDatePickerContentControl(Range, String) Aggiunge un nuovo oggetto DatePickerContentControl in corrispondenza dell'intervallo specificato nel documento.
Metodo pubblico AddDropDownListContentControl(String) Aggiunge un nuovo oggetto DropDownListContentControl in corrispondenza della selezione corrente nel documento.
Metodo pubblico AddDropDownListContentControl(ContentControl, String) Aggiunge un nuovo DropDownListContentControl all'insieme.Il nuovo controllo si basa su un controllo contenuto nativo già presente nel documento.
Metodo pubblico AddDropDownListContentControl(Range, String) Aggiunge un nuovo oggetto DropDownListContentControl in corrispondenza dell'intervallo specificato nel documento.
Metodo pubblico AddGroupContentControl(String) Aggiunge un nuovo oggetto GroupContentControl in corrispondenza della selezione corrente nel documento.
Metodo pubblico AddGroupContentControl(ContentControl, String) Aggiunge un nuovo oggetto GroupContentControl basato su un controllo del contenuto nativo presente nel documento.
Metodo pubblico AddGroupContentControl(Range, String) Aggiunge un nuovo oggetto GroupContentControl in corrispondenza dell'intervallo specificato nel documento.
Metodo pubblico AddPictureContentControl(String) Aggiunge un nuovo oggetto PictureContentControl in corrispondenza della selezione corrente nel documento.
Metodo pubblico AddPictureContentControl(ContentControl, String) Aggiunge un nuovo oggetto PictureContentControl basato su un controllo del contenuto nativo presente nel documento.
Metodo pubblico AddPictureContentControl(Range, String) Aggiunge un nuovo oggetto PictureContentControl in corrispondenza dell'intervallo specificato nel documento.
Metodo pubblico AddPlainTextContentControl(String) Aggiunge un nuovo oggetto PlainTextContentControl in corrispondenza della selezione corrente nel documento.
Metodo pubblico AddPlainTextContentControl(ContentControl, String) Aggiunge un nuovo oggetto PlainTextContentControl basato su un controllo del contenuto nativo presente nel documento.
Metodo pubblico AddPlainTextContentControl(Range, String) Aggiunge un nuovo oggetto PlainTextContentControl in corrispondenza dell'intervallo specificato nel documento.
Metodo pubblico AddRichTextContentControl(String) Aggiunge un nuovo oggetto RichTextContentControl in corrispondenza della selezione corrente nel documento.
Metodo pubblico AddRichTextContentControl(ContentControl, String) Aggiunge un nuovo oggetto RichTextContentControl basato su un controllo del contenuto nativo presente nel documento.
Metodo pubblico AddRichTextContentControl(Range, String) Aggiunge un nuovo oggetto RichTextContentControl in corrispondenza dell'intervallo specificato nel documento.
Metodo pubblico Contains(Object) Determina se il controllo specificato è un membro dell'istanza di ControlCollection.
Metodo pubblico Contains(String) Determina se il controllo specificato è un membro dell'istanza di ControlCollection.
Metodo pubblico GetEnumerator Viene restituito un enumeratore che scorre un insieme. (Ereditato da IEnumerable)
Metodo pubblico GetInlineShapeForControl Ottiene l'oggetto InlineShape sottostante per il controllo specificato.
Metodo pubblico GetShapeForControl Ottiene l'oggetto Shape sottostante per il controllo specificato.
Metodo pubblico IndexOf(Object) Esegue la ricerca del controllo specificato e restituisce l'indice in base zero della prima occorrenza nell'istanza di ControlCollection.
Metodo pubblico IndexOf(String) Cerca la prima occorrenza di un controllo con il nome specificato nell'istanza di ControlCollection.
Metodo pubblico Remove(Object) Rimuove il controllo specificato dall'istanza di ControlCollection.
Metodo pubblico Remove(String) Rimuove il controllo specificato dall'istanza di ControlCollection.
Metodo pubblico RemoveAt Rimuove il controllo in corrispondenza dell'indice specificato nell'istanza di ControlCollection.

In alto

Note

Utilizzare i metodi ControlCollection e le proprietà per gestire i controlli su un documento di Word. Per ulteriori informazioni, vedere Aggiunta di controlli ai documenti di Office in fase di esecuzione.

Per ottenere un oggetto ControlCollection in un progetto a livello di documento, utilizzare la proprietà Controls della classe ThisDocument nel progetto. Per ottenere un oggetto ControlCollection in un progetto a livello di applicazione, utilizzare la proprietà Controls di un elemento host Document creato a livello di codice in fase di esecuzione. Per ulteriori informazioni, vedere Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione.

Nella tabella riportata di seguito viene illustrato come utilizzare i membri di ControlCollection per l'esecuzione di alcune attività comuni legate ai controlli nei documenti.

Task

Azione

Aggiungere un controllo al documento.

Utilizzare uno dei metodi AddNomeControllo. Ad esempio, per aggiungere un controllo di contenuto utilizzare il metodo AddContentControl.

Rimuovere un controllo dal documento.

Utilizzare il metodo Remove.

Determinare se un controllo è incluso nella raccolta.

Passare il controllo o il relativo nome al metodo Contains.

Ottenere l'indice di un controllo nell'insieme.

Passare il controllo o il relativo nome al metodo IndexOf.

Ottenere un controllo dalla raccolta.

Passare l'indice o il nome del controllo alla proprietà Item.

Nota

Questa interfaccia è implementata da Visual Studio Tools per Office Runtime. Non deve essere implementata nel codice. Per ulteriori informazioni, vedere Cenni preliminari su Visual Studio Tools per Office Runtime.

Utilizzo

Nella presente documentazione viene descritta la versione di questo tipo utilizzata nei progetti di Office destinati a .NET Framework 4. Nei progetti destinati a .NET Framework 3.5, questo tipo potrebbe avere membri diversi e gli esempi di codice forniti per il tipo potrebbero non funzionare. Per la documentazione relativa a questo tipo nei progetti destinati a .NET Framework 3.5, vedere la sezione di riferimento seguente nella documentazione di Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.Office.Tools.Word

Altre risorse

Aggiunta di controlli ai documenti di Office in fase di esecuzione

Metodi di supporto per i controlli host