Interfaccia ControlCollection

Articolo
08/11/2011

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
	Capacity	Ottiene o imposta il numero di controlli che l'oggetto ControlCollection può contenere.
	Count	Ottiene il numero di controlli inclusi in ControlCollection.
	Item[Int32]	Ottiene il controllo in corrispondenza dell'indice specificato.
	Item[Object]	Ottiene il controllo specificato.
	Item[String]	Ottiene il controllo con il nome specificato.

In alto

Metodi

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