Interfaccia ContentControl

Articolo
08/11/2011

Rappresenta un controllo contenuto relativo a un documento.

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

Sintassi

'Dichiarazione
<GuidAttribute("ee82979b-2814-48b1-95dd-4bfcc636a7ec")> _
Public Interface ContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("ee82979b-2814-48b1-95dd-4bfcc636a7ec")]
public interface ContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

Il tipo ContentControl espone i seguenti membri.

Proprietà

	Nome	Descrizione
	Application	Ottiene un oggetto Microsoft.Office.Interop.Word.Application che rappresenta l'istanza corrente di Microsoft Office Word.
	BindingContext	Ottiene o imposta l'insieme di gestori della valuta per l'interfaccia IBindableComponent. (Ereditato da IBindableComponent)
	BuildingBlockCategory	Ottiene o imposta la categoria di blocchi predefiniti visualizzati in ContentControl, che rappresenta una raccolta di blocchi predefiniti.
	BuildingBlockType	Ottiene o imposta il tipo di blocchi predefiniti visualizzati in ContentControl, che rappresenta una raccolta di blocchi predefiniti.
	Checked	Ottiene o imposta un valore che indica se un oggetto ContentControl che rappresenta un controllo casella di controllo è selezionato o deselezionato.Questa proprietà può essere utilizzata solo nei progetti di Word 2010.
	Container	Infrastruttura. (Ereditato da ContentControlBase)
	ContainerComponent	Infrastruttura. (Ereditato da ContentControlBase)
	Creator	Ottiene un Integer a 32 bit che indica l'applicazione in cui l'oggetto ContentControl è stato creato.
	DataBindings	Ottiene l'insieme di oggetti di associazione dati per questa interfaccia IBindableComponent. (Ereditato da IBindableComponent)
	DateCalendarType	Ottiene o imposta il tipo di calendario visualizzato in un oggetto ContentControl, che rappresenta una selezione data.
	DateDisplayFormat	Ottiene o imposta una stringa che specifica il formato data visualizzato in ContentControl, che rappresenta una selezione data.
	DateDisplayLocale	Ottiene o imposta il formato data associato alla lingua visualizzata in un oggetto ContentControl che rappresenta una selezione data.
	DateStorageFormat	Ottiene o imposta il formato in cui le date vengono salvate in una web part XML personalizzata da parte di ContentControl che rappresenta una selezione data.
	DefaultDataSourceUpdateMode	Ottiene o imposta l'oggetto DataSourceUpdateMode predefinito per ContentControlBase. (Ereditato da ContentControlBase)
	DefaultTextStyle	Ottiene il nome dello stile carattere utilizzato per la formattazione del testo in ContentControl.
	DropDownListEntries	Ottiene l'insieme degli elementi visualizzati da ContentControl che rappresenta un elenco a discesa o una casella combinata.
	ID	Ottiene un numero univoco che identifica il controllo contenuto. (Ereditato da ContentControlBase)
	InnerObject	Ottiene l'oggetto Microsoft.Office.Interop.Word.ContentControl sottostante per l'oggetto Microsoft.Office.Tools.Word.ContentControlBase. (Ereditato da ContentControlBase)
	LockContentControl	Ottiene o imposta un valore che specifica la possibilità o meno di eliminare ContentControl dal documento.
	LockContents	Ottiene o imposta un valore che specifica la possibilità o meno di modificare il contenuto di ContentControl.
	MultiLine	Ottiene o imposta un valore che specifica la possibilità che ContentControl contenga o meno interruzioni di riga.
	Parent	Ottiene l'elemento padre di ContentControl.
	ParentContentControl	Ottiene il controllo contenuto padre di un oggetto ContentControl annidato all'interno di un altro controllo contenuto.
	PlaceholderText	Ottiene il testo visualizzato in ContentControl fino a quando il testo non viene modificato mediante un'azione dell'utente o altre operazioni.
	Range	Ottiene un oggetto Range che rappresenta il contenuto di ContentControl.
	ShowingPlaceholderText	Ottiene un valore che specifica se il testo segnaposto è attualmente visualizzato o meno da ContentControl.
	Site	Ottiene o imposta l'oggetto ISite associato a IComponent. (Ereditato da IComponent)
	Tag	Ottiene o imposta una stringa che si desidera associare a ContentControl.
	Temporary	Ottiene o imposta un valore che specifica se l'oggetto ContentControl viene o meno eliminato automaticamente dal documento in caso di modifica del controllo.
	Title	Ottiene o imposta il titolo della classe ContentControl.
	Type	Ottiene o imposta un valore che specifica il tipo di controllo contenuto rappresentato da ContentControl.
	XMLMapping	Ottiene un oggetto XMLMapping che rappresenta l'associazione tra l'oggetto ContentControl e un elemento in una web part XML personalizzata.

In alto

Metodi

	Nome	Descrizione
	BeginInit	Consente di segnalare all'oggetto che l'inizializzazione sta per essere avviata. (Ereditato da ISupportInitialize)
	Copy	Effettua una copia di ContentControl dal documento e la aggiunge agli Appunti.
	Cut	Rimuove l'oggetto ContentControl dal documento e lo aggiunge agli Appunti.
	Delete	Elimina dal documento un controllo contenuto creato in modo dinamico e lo rimuove da ControlCollection nel documento. (Ereditato da ContentControlBase)
	Dispose	Esegue attività definite dall'applicazione, ad esempio libera, rilascia o reimposta risorse non gestite. (Ereditato da IDisposable)
	EndInit	Consente di segnalare all'oggetto che l'inizializzazione è completa. (Ereditato da ISupportInitialize)
	SetCheckedSymbol	Imposta il simbolo utilizzato per rappresentare lo stato di selezione di un oggetto ContentControl che rappresenta un controllo casella di controllo.Questo metodo può essere utilizzato solo nei progetti di Word 2010.
	SetPlaceholderText	Visualizza il testo contenuto in BuildingBlock, in Range o in una stringa come testo segnaposto nell'oggetto ContentControl.
	SetUncheckedSymbol	Imposta il simbolo utilizzato per rappresentare lo stato di deselezione di un oggetto ContentControl che rappresenta un controllo casella di controllo.Questo metodo può essere utilizzato solo nei progetti di Word 2010.
	Ungroup	Rimuove dal documento il controllo contenuto di gruppo contenente ContentControl in modo che l'area non sia più protetta.

In alto

Eventi

	Nome	Descrizione
	Added	Si verifica dopo l'aggiunta di un controllo contenuto al documento. (Ereditato da ContentControlBase)
	BindingContextChanged	Si verifica quando il valore della proprietà BindingContext di ContentControlBase cambia. (Ereditato da ContentControlBase)
	ContentUpdating	Si verifica poco prima che Microsoft Office Word aggiorni automaticamente il testo di un controllo contenuto associato a una web part XML personalizzata. (Ereditato da ContentControlBase)
	Deleting	Si verifica poco prima dell'eliminazione del controllo contenuto dal documento. (Ereditato da ContentControlBase)
	Disposed	Rappresenta il metodo che gestisce l'evento Disposed di un componente. (Ereditato da IComponent)
	Entering	Si verifica quando l'utente fa clic nel controllo contenuto oppure quando il cursore viene spostato nel controllo contenuto a livello di codice. (Ereditato da ContentControlBase)
	Exiting	Si verifica quando l'utente fa clic all'esterno del controllo contenuto oppure quando il cursore viene spostato all'esterno del controllo contenuto a livello di codice. (Ereditato da ContentControlBase)
	StoreUpdating	Si verifica poco prima che Microsoft Office Word aggiorni i dati in una web part XML personalizzata associata al controllo contenuto, vale a dire dopo la modifica del testo nel controllo contenuto. (Ereditato da ContentControlBase)
	Validated	Si verifica in caso di esito positivo della convalida del controllo contenuto. (Ereditato da ContentControlBase)
	Validating	Si verifica in caso di convalida del contenuto del controllo contenuto. (Ereditato da ContentControlBase)

In alto

Note

Un oggetto ContentControl costituisce un controllo mutevole che può rappresentare uno qualsiasi degli otto tipi di controlli utilizzabili in Microsoft Office Word. Se ad esempio si crea un oggetto ContentControl con funzionalità iniziale di controllo testo normale, sarà possibile modificarlo in fase di esecuzione in modo che si comporti come una casella combinata. Non è possibile utilizzare in questo modo altri controlli contenuto. RichTextContentControl, ad esempio, può rappresentare unicamente un controllo RTF. Per ulteriori informazioni sui controlli contenuto, vedere Controlli del contenuto.

Per creare ContentControl, utilizzare uno dei metodi AddContentControl. Non è possibile aggiungere ContentControl a un documento in fase di progettazione

Nella creazione di ContentControl è necessario specificare il tipo di controllo contenuto che si desidera creare. In alternativa è possibile basare il nuovo controllo su un controllo contenuto esistente. Una volta creato un oggetto ContentControl è possibile modificare il tipo di controllo contenuto da esso rappresentato utilizzando la proprietà Type.

Se utilizzati quando il controllo è impostato su un tipo di controllo che non può utilizzare il membro, alcuni membri ContentControl generano un'eccezione. Il tentativo di utilizzare la proprietà DateCalendarType su un oggetto ContentControl che non rappresenta una selezione data genera un'eccezione.

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.