Classe ComboBoxContentControl (System 2007)
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";
}
Gerarchia di ereditarietà
System.Object
Microsoft.VisualStudio.Tools.Office.RemoteComponent
Microsoft.VisualStudio.Tools.Office.RemoteBindableComponent
Microsoft.Office.Tools.Word.ContentControlBase
Microsoft.Office.Tools.Word.ComboBoxContentControl
Codice thread safe
Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Vedere anche
Riferimenti
Spazio dei nomi Microsoft.Office.Tools.Word
Altre risorse
Procedura: aggiungere controlli del contenuto ai documenti di Word
Procedura: proteggere parti di documenti mediante i controlli del contenuto
Procedura dettagliata: creazione di un modello utilizzando i controlli del contenuto
Cronologia delle modifiche
Date |
History |
Motivo |
---|---|---|
Luglio 2008 |
Aggiunta una versione dell'esempio di codice per un componente aggiuntivo a livello di applicazione. |
Modifica di funzionalità in SP1. |