ControlCollection.AddComboBoxContentControl (Método) (Range, String)
Agrega un nuevo control ComboBoxContentControl en el intervalo especificado del documento.
Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)
Sintaxis
'Declaración
Function AddComboBoxContentControl ( _
range As Range, _
name As String _
) As ComboBoxContentControl
ComboBoxContentControl AddComboBoxContentControl(
Range range,
string name
)
Parámetros
- range
Tipo: Microsoft.Office.Interop.Word.Range
Range que proporciona los límites del nuevo control.
- name
Tipo: System.String
Nombre del nuevo control.
Valor devuelto
Tipo: Microsoft.Office.Tools.Word.ComboBoxContentControl
El control ComboBoxContentControl que se agregó al documento.
Excepciones
Excepción | Condición |
---|---|
ArgumentNullException | name es nullreferencia null (Nothing en Visual Basic) o tiene longitud cero. |
ControlNameAlreadyExistsException | Ya existe un control con el mismo nombre en ControlCollection. |
Comentarios
Utilice este método para agregar un nuevo control ComboBoxContentControl en un intervalo especificado del documento en tiempo de ejecución.Para obtener más información, vea Agregar controles a documentos de Office en tiempo de ejecución.
Ejemplos
En el ejemplo de código siguiente se agrega un nuevo ComboBoxContentControl al principio del documento.En el ejemplo se agregan también los nombres de varios colores a la lista de elementos que los usuarios pueden seleccionar en el control.
Se trata de una versión para una personalización en el nivel del documento.Para usar este código, péguelo en la clase ThisDocument del proyecto y llame al método AddComboBoxControlAtRange desde el método ThisDocument_Startup.
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";
}
Esta versión es para un complemento de nivel de aplicación que tiene como destino .NET Framework 4 o .NET Framework 4.5.Para usar este código, péguelo en la clase ThisAddIn del proyecto y llame al método AddComboBoxControlAtRange desde el método ThisAddIn_Startup.
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 = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
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 = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
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";
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.
Vea también
Referencia
AddComboBoxContentControl (Sobrecarga)
Microsoft.Office.Tools.Word (Espacio de nombres)
Otros recursos
Agregar controles a documentos de Office en tiempo de ejecución