Classe ComboBoxContentControl (System 2007)

Articolo
09/12/2008

Aggiornamento: Luglio 2008

Rappresenta una casella combinata in un documento.

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

Sintassi

<DefaultBindingPropertyAttribute("Text")> _
<PermissionSetAttribute(SecurityAction.Demand, Name := "FullTrust")> _
Public NotInheritable Class ComboBoxContentControl _
    Inherits ContentControlBase _
    Implements ISupportInitializeControl, ISupportInitialize

Dim instance As ComboBoxContentControl

[DefaultBindingPropertyAttribute("Text")]
[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public sealed class ComboBoxContentControl : ContentControlBase, 
    ISupportInitializeControl, ISupportInitialize

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.

Controlli 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 contenuto.

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 = Me.Application.ActiveDocument.GetVstoObject()
    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 = this.Application.ActiveDocument.GetVstoObject();
    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";            
}