ControlCollection.AddComboBoxContentControl-Methode (Range, String) (2007 System)
Aktualisiert: Juli 2008
Fügt dem Dokument im angegebenen Bereich ein neues ComboBoxContentControl hinzu.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v9.0 (in Microsoft.Office.Tools.Word.v9.0.dll)
Syntax
'Declaration
Public Function AddComboBoxContentControl ( _
range As Range, _
name As String _
) As ComboBoxContentControl
'Usage
Dim instance As ControlCollection
Dim range As Range
Dim name As String
Dim returnValue As ComboBoxContentControl
returnValue = instance.AddComboBoxContentControl(range, _
name)
public ComboBoxContentControl AddComboBoxContentControl(
Range range,
string name
)
Parameter
range
Typ: Microsoft.Office.Interop.Word.RangeEin Range, der die Begrenzungen des neuen Steuerelements angibt.
name
Typ: System.StringDer Name des neuen Steuerelements.
Rückgabewert
Typ: Microsoft.Office.Tools.Word.ComboBoxContentControl
Das ComboBoxContentControl, das dem Dokument hinzugefügt wurde.
Ausnahmen
Ausnahme | Bedingung |
---|---|
ArgumentNullException | name ist nullNULL-Verweis (Nothing in Visual Basic) oder hat die Länge 0 (null). |
ControlNameAlreadyExistsException | Ein Steuerelement mit dem gleichen Namen ist bereits in der ControlCollection vorhanden. |
Hinweise
Verwenden Sie diese Methode, um in einem angegebenen Bereich im Dokument zur Laufzeit ein neues ComboBoxContentControl hinzuzufügen. Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.
Beispiele
Im folgenden Codebeispiel wird am Anfang des Dokuments ein neues ComboBoxContentControl hinzugefügt. Im Beispiel werden auch die Namen verschiedener Farben zur Liste der Elemente hinzugefügt, die Benutzer im Steuerelement auswählen können.
Diese Version bezieht sich auf eine Anpassung auf Dokumentebene. Zum Verwenden dieses Codes fügen Sie ihn in der ThisDocument-Klasse in das Projekt ein und rufen in der ThisDocument_Startup-Methode die AddComboBoxControlAtRange-Methode auf.
Dim comboBoxControl2 As Microsoft.Office.Tools.Word.ComboBoxContentControl
Private Sub AddComboBoxControlAtRange()
Me.Paragraphs(1).Range.InsertParagraphBefore()
comboBoxControl2 = Me.Controls.AddComboBoxContentControl(Me.Paragraphs(1).Range, "comboBoxControl2")
With comboBoxControl2
.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 comboBoxControl2;
private void AddComboBoxControlAtRange()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
comboBoxControl2 = this.Controls.AddComboBoxContentControl(this.Paragraphs[1].Range,
"comboBoxControl2");
comboBoxControl2.DropDownListEntries.Add("Red", "Red", 0);
comboBoxControl2.DropDownListEntries.Add("Green", "Green", 1);
comboBoxControl2.DropDownListEntries.Add("Blue", "Blue", 2);
comboBoxControl2.PlaceholderText = "Choose a color, or enter your own";
}
Diese Version bezieht sich auf ein Add-In auf Anwendungsebene. Zum Verwenden dieses Codes fügen Sie ihn in der ThisAddIn-Klasse in das Projekt ein und rufen in der ThisAddIn_Startup-Methode die AddComboBoxControlAtRange-Methode auf.
Dim comboBoxControl2 As Microsoft.Office.Tools.Word.ComboBoxContentControl
Private Sub AddComboBoxControlAtRange()
If Me.Application.ActiveDocument Is Nothing Then
Return
End If
Dim vstoDoc As Document = Me.Application.ActiveDocument.GetVstoObject()
vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
comboBoxControl2 = vstoDoc.Controls.AddComboBoxContentControl( _
vstoDoc.Paragraphs(1).Range, "comboBoxControl2")
With comboBoxControl2
.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 comboBoxControl2;
private void AddComboBoxControlAtRange()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = this.Application.ActiveDocument.GetVstoObject();
vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
comboBoxControl2 = vstoDoc.Controls.AddComboBoxContentControl(
vstoDoc.Paragraphs[1].Range,
"comboBoxControl2");
comboBoxControl2.DropDownListEntries.Add("Red", "Red", 0);
comboBoxControl2.DropDownListEntries.Add("Green", "Green", 1);
comboBoxControl2.DropDownListEntries.Add("Blue", "Blue", 2);
comboBoxControl2.PlaceholderText = "Choose a color, or enter your own";
}
Berechtigungen
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.
Siehe auch
Referenz
AddComboBoxContentControl-Überladung
Microsoft.Office.Tools.Word-Namespace
Weitere Ressourcen
Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit
Hilfsmethoden für Hoststeuerelemente
Gewusst wie: Hinzufügen von Inhaltssteuerelementen zu Word-Dokumenten
Änderungsprotokoll
Date |
Versionsgeschichte |
Grund |
---|---|---|
Juli 2008 |
Version des Codebeispiels für ein Add-In auf Anwendungsebene hinzugefügt. |
SP1-Featureänderung. |