Interfaccia ComboBoxContentControl

Articolo
05/17/2013

Rappresenta una casella combinata in un documento.

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

Sintassi

'Dichiarazione
<GuidAttribute("fff2d316-e224-4cd9-a10c-3edf95689a6d")> _
Public Interface ComboBoxContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("fff2d316-e224-4cd9-a10c-3edf95689a6d")]
public interface ComboBoxContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

Il tipo ComboBoxContentControl 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 la raccolta di l per IBindableComponent. (Ereditato da IBindableComponent)
	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 ComboBoxContentControl è stato creato.
	DataBindings	Ottiene la raccolta di associazione dati oggetti per questo IBindableComponent. (Ereditato da IBindableComponent)
	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 ComboBoxContentControl.
	DropDownListEntries	Ottiene la raccolta di elementi visualizzati da ComboBoxContentControl.
	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 se è possibile eliminare ComboBoxContentControl dal documento.
	LockContents	Ottiene o imposta un valore che specifica la possibilità o meno di modificare il contenuto di ComboBoxContentControl.
	MultiLine	Ottiene o imposta un valore che specifica la possibilità che ComboBoxContentControl contenga o meno interruzioni di riga.
	Parent	Ottiene l'elemento padre di ComboBoxContentControl.
	ParentContentControl	Ottiene il controllo contenuto padre di un oggetto ComboBoxContentControl annidato all'interno di un altro controllo contenuto.
	PlaceholderText	Ottiene o imposta il testo visualizzato in ComboBoxContentControl 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 ComboBoxContentControl.
	ShowingPlaceholderText	Ottiene un valore che specifica se il testo segnaposto è attualmente visualizzato o meno da ComboBoxContentControl.
	Site	ottiene o imposta ISite associato IComponent. (Ereditato da IComponent)
	Tag	Ottiene o imposta una stringa da associare a ComboBoxContentControl.
	Temporary	Ottiene o imposta un valore che specifica se l'oggetto ComboBoxContentControl viene o meno eliminato automaticamente dal documento in caso di modifica del controllo.
	Text	Ottiene o imposta il testo nell'oggetto ComboBoxContentControl.
	Title	Ottiene o imposta il titolo della classe ComboBoxContentControl.
	XMLMapping	Ottiene un oggetto Microsoft.Office.Interop.Word.XMLMapping che rappresenta l'associazione tra ComboBoxContentControl e un elemento in una web part XML personalizzata.

In alto

Metodi

	Nome	Descrizione
	BeginInit	Segnala l'oggetto che l'inizializzazione è iniziale. (Ereditato da ISupportInitialize)
	Copy	Effettua una copia di ComboBoxContentControl dal documento e la aggiunge agli Appunti.
	Cut	Rimuove l'oggetto ComboBoxContentControl 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 le attività definite dall'applicazione associate alla versione, il rilascio, o reimpostare le risorse non gestite. (Ereditato da IDisposable)
	EndInit	segnala l'oggetto che l'inizializzazione è completa. (Ereditato da ISupportInitialize)
	SetPlaceholderText	Visualizza il testo contenuto in T:Microsoft.Office.Interop.Word.BuildingBlock, in Range o in una stringa come testo segnaposto nell'oggetto ComboBoxContentControl.

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 Disposed evento 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

ComboBoxContentControl visualizza un elenco di elementi selezionabili.All'interno di ComboBoxContentControl è inoltre possibile digitare del testo.

Per visualizzare un elenco a discesa degli elementi in una casella di testo non modificabile, utilizzare DropDownListContentControl.

Per accedere all'elenco degli elementi contenuti in ComboBoxContentControl, utilizzare la proprietà DropDownListEntries.

[!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.

Controlli del contenuto

ComboBoxContentControl è uno degli otto tipi di controlli contenuto utilizzabili per la progettazione di documenti e modelli in Microsoft Office Word.I controlli contenuto dispongono di un'interfaccia utente (UI) con controllo di input come un form.Tali controlli contenuto possono essere utilizzati per impedire la modifica di sezioni protette del documento o del modello e inoltre possono essere associati a un'origine dati.Per ulteriori informazioni, vedere Controlli del contenuto.

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.

Esempi

Nell'esempio di codice seguente viene aggiunto un nuovo oggetto ComboBoxContentControl all'inizio del documento.Gli utenti possono selezionare un nome di colore visualizzato dal controllo oppure digitare il nome di un nuovo colore.

Questa versione è valida per una personalizzazione a livello di documento.Per utilizzare questo codice, incollarlo nella classe ThisDocument del progetto, quindi chiamare il metodo AddComboBoxControlAtSelection dal metodo ThisDocument_Startup.

Dim comboBoxControl1 As Microsoft.Office.Tools.Word.ComboBoxContentControl

Private Sub AddComboBoxControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    comboBoxControl1 = Me.Controls.AddComboBoxContentControl("comboBoxControl1")
    With comboBoxControl1
        .DropDownListEntries.Add("Red", "Red", 0)
        .DropDownListEntries.Add("Green", "Green", 1)
        .DropDownListEntries.Add("Blue", "Blue", 2)
        .PlaceholderText = "Choose a color, or enter your own"
    End With
End Sub

private Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl1;

private void AddComboBoxControlAtSelection()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.Select();

    comboBoxControl1 = this.Controls.AddComboBoxContentControl("comboBoxControl1");
    comboBoxControl1.DropDownListEntries.Add("Red", "Red", 0);
    comboBoxControl1.DropDownListEntries.Add("Green", "Green", 1);
    comboBoxControl1.DropDownListEntries.Add("Blue", "Blue", 2);
    comboBoxControl1.PlaceholderText = "Choose a color, or enter your own";
}

Questa versione è valida per un componente aggiuntivo a livello di applicazione.Per utilizzare questo codice, incollarlo nella classe ThisAddIn del progetto, quindi chiamare il metodo AddComboBoxControlAtSelection dal metodo ThisAddIn_Startup.

Dim comboBoxControl1 As Microsoft.Office.Tools.Word.ComboBoxContentControl

Private Sub AddComboBoxControlAtSelection()
    If Me.Application.ActiveDocument Is Nothing Then
        Return
    End If

    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
    vstoDoc.Paragraphs(1).Range.Select()
    comboBoxControl1 = vstoDoc.Controls.AddComboBoxContentControl("comboBoxControl1")
    With comboBoxControl1
        .DropDownListEntries.Add("Red", "Red", 0)
        .DropDownListEntries.Add("Green", "Green", 1)
        .DropDownListEntries.Add("Blue", "Blue", 2)
        .PlaceholderText = "Choose a color, or enter your own"
    End With
End Sub

private Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl1;

private void AddComboBoxControlAtSelection()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
    vstoDoc.Paragraphs[1].Range.Select();

    comboBoxControl1 = vstoDoc.Controls.AddComboBoxContentControl(
        "comboBoxControl1");
    comboBoxControl1.DropDownListEntries.Add("Red", "Red", 0);
    comboBoxControl1.DropDownListEntries.Add("Green", "Green", 1);
    comboBoxControl1.DropDownListEntries.Add("Blue", "Blue", 2);
    comboBoxControl1.PlaceholderText = "Choose a color, or enter your own";            
}