Condividi tramite


Interfaccia ContentControl

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
Proprietà pubblica Application Ottiene un oggetto Microsoft.Office.Interop.Word.Application che rappresenta l'istanza corrente di Microsoft Office Word.
Proprietà pubblica BindingContext Ottiene o imposta la raccolta di l per IBindableComponent. (Ereditato da IBindableComponent)
Proprietà pubblica BuildingBlockCategory Ottiene o imposta la categoria di blocchi predefiniti visualizzati in ContentControl, che rappresenta una raccolta di blocchi predefiniti.
Proprietà pubblica BuildingBlockType Ottiene o imposta il tipo di blocchi predefiniti visualizzati in ContentControl, che rappresenta una raccolta di blocchi predefiniti.
Proprietà pubblica Checked Ottiene o imposta un valore che indica se un oggetto ContentControl che rappresenta un controllo casella di controllo è selezionato o deselezionato.
Proprietà pubblica Container Infrastruttura. (Ereditato da ContentControlBase)
Proprietà pubblica ContainerComponent Infrastruttura. (Ereditato da ContentControlBase)
Proprietà pubblica Creator Ottiene un Integer a 32 bit che indica l'applicazione in cui l'oggetto ContentControl è stato creato.
Proprietà pubblica DataBindings Ottiene la raccolta di associazione dati oggetti per questo IBindableComponent. (Ereditato da IBindableComponent)
Proprietà pubblica DateCalendarType Ottiene o imposta il tipo di calendario visualizzato in un oggetto ContentControl, che rappresenta una selezione data.
Proprietà pubblica DateDisplayFormat Ottiene o imposta una stringa che specifica il formato data visualizzato in ContentControl, che rappresenta una selezione data.
Proprietà pubblica DateDisplayLocale Ottiene o imposta il formato data associato alla lingua visualizzata in un oggetto ContentControl che rappresenta una selezione data.
Proprietà pubblica 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.
Proprietà pubblica DefaultDataSourceUpdateMode Ottiene o imposta l'oggetto DataSourceUpdateMode predefinito per ContentControlBase. (Ereditato da ContentControlBase)
Proprietà pubblica DefaultTextStyle Ottiene il nome dello stile carattere utilizzato per la formattazione del testo in ContentControl.
Proprietà pubblica DropDownListEntries Ottiene la raccolta degli elementi visualizzati da ContentControl che rappresenta un elenco a discesa o una casella combinata.
Proprietà pubblica ID Ottiene un numero univoco che identifica il controllo contenuto. (Ereditato da ContentControlBase)
Proprietà pubblica InnerObject Ottiene l'oggetto Microsoft.Office.Interop.Word.ContentControl sottostante per l'oggetto Microsoft.Office.Tools.Word.ContentControlBase. (Ereditato da ContentControlBase)
Proprietà pubblica LockContentControl Ottiene o imposta un valore che specifica la possibilità o meno di eliminare ContentControl dal documento.
Proprietà pubblica LockContents Ottiene o imposta un valore che specifica la possibilità o meno di modificare il contenuto di ContentControl.
Proprietà pubblica MultiLine Ottiene o imposta un valore che specifica la possibilità che ContentControl contenga o meno interruzioni di riga.
Proprietà pubblica Parent Ottiene l'elemento padre di ContentControl.
Proprietà pubblica ParentContentControl Ottiene il controllo contenuto padre di un oggetto ContentControl annidato all'interno di un altro controllo contenuto.
Proprietà pubblica PlaceholderText Ottiene il testo visualizzato in ContentControl fino a quando il testo non viene modificato mediante un'azione dell'utente o altre operazioni.
Proprietà pubblica Range Ottiene un oggetto Range che rappresenta il contenuto di ContentControl.
Proprietà pubblica ShowingPlaceholderText Ottiene un valore che specifica se il testo segnaposto è attualmente visualizzato o meno da ContentControl.
Proprietà pubblica Site ottiene o imposta ISite associato IComponent. (Ereditato da IComponent)
Proprietà pubblica Tag Ottiene o imposta una stringa che si desidera associare a ContentControl.
Proprietà pubblica 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.
Proprietà pubblica Title Ottiene o imposta il titolo della classe ContentControl.
Proprietà pubblica Type Ottiene o imposta un valore che specifica il tipo di controllo contenuto rappresentato da ContentControl.
Proprietà pubblica 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
Metodo pubblico BeginInit Segnala l'oggetto che l'inizializzazione è iniziale. (Ereditato da ISupportInitialize)
Metodo pubblico Copy Effettua una copia di ContentControl dal documento e la aggiunge agli Appunti.
Metodo pubblico Cut Rimuove l'oggetto ContentControl dal documento e lo aggiunge agli Appunti.
Metodo pubblico Delete Elimina dal documento un controllo contenuto creato in modo dinamico e lo rimuove da ControlCollection nel documento. (Ereditato da ContentControlBase)
Metodo pubblico Dispose Esegue le attività definite dall'applicazione associate alla versione, il rilascio, o reimpostare le risorse non gestite. (Ereditato da IDisposable)
Metodo pubblico EndInit segnala l'oggetto che l'inizializzazione è completa. (Ereditato da ISupportInitialize)
Metodo pubblico SetCheckedSymbol Imposta il simbolo utilizzato per rappresentare lo stato di selezione di un oggetto ContentControl che rappresenta un controllo casella di controllo.
Metodo pubblico SetPlaceholderText Visualizza il testo contenuto in BuildingBlock, in Range o in una stringa come testo segnaposto nell'oggetto ContentControl.
Metodo pubblico SetUncheckedSymbol Imposta il simbolo utilizzato per rappresentare lo stato incluso nel controllo di ContentControl che rappresenta un controllo casella di controllo
Metodo pubblico 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
Evento pubblico Added Si verifica dopo l'aggiunta di un controllo contenuto al documento. (Ereditato da ContentControlBase)
Evento pubblico BindingContextChanged Si verifica quando il valore della proprietà BindingContext di ContentControlBase cambia. (Ereditato da ContentControlBase)
Evento pubblico 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)
Evento pubblico Deleting Si verifica poco prima dell'eliminazione del controllo contenuto dal documento. (Ereditato da ContentControlBase)
Evento pubblico Disposed rappresenta il metodo che gestisce Disposed evento di un componente. (Ereditato da IComponent)
Evento pubblico 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)
Evento pubblico 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)
Evento pubblico 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)
Evento pubblico Validated Si verifica in caso di esito positivo della convalida del controllo contenuto. (Ereditato da ContentControlBase)
Evento pubblico 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 dal Runtime di Visual Studio Tools per Office. 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 e .NET Framework 4.5. 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

Controlli del contenuto

Procedura: aggiungere controlli del contenuto ai documenti di Word

Procedura: proteggere parti di documenti mediante i controlli del contenuto