InsertComboBox

DocumentBuilder.InsertComboBox method

Inserta un campo de formulario de cuadro combinado en la posición actual.

public FormField InsertComboBox(string name, string[] items, int selectedIndex)
ParámetroEscribeDescripción
nameStringEl nombre del campo del formulario. Puede ser una cadena vacía. El valor de más de 20 caracteres se truncará.
itemsString[]Los elementos del ComboBox. El máximo es 25 artículos.
selectedIndexInt32El índice del elemento seleccionado en el ComboBox.

Valor_devuelto

El nodo del campo de formulario que se acaba de insertar.

Observaciones

Si especifica un nombre para el campo del formulario, se crea automáticamente un marcador con el mismo nombre.

Ejemplos

Muestra cómo insertar un campo de formulario de cuadro combinado en un documento.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insertar un formulario que solicite al usuario que elija uno de los elementos del menú.
builder.Write("Pick a fruit: ");
string[] items = { "Apple", "Banana", "Cherry" };
builder.InsertComboBox("DropDown", items, 0);

doc.Save(ArtifactsDir + "DocumentBuilder.InsertComboBox.docx");

Muestra cómo crear campos de formulario.

DocumentBuilder builder = new DocumentBuilder();

// Los campos de formulario son objetos en el documento con los que el usuario puede interactuar al solicitarle que ingrese valores.
// Podemos crearlos usando un generador de documentos y a continuación se muestran dos formas de hacerlo.
// 1 - Entrada de texto básico:
builder.InsertTextInput("My text input", TextFormFieldType.Regular, 
    "", "Enter your name here", 30);

// 2 - Cuadro combinado con texto emergente y un rango de valores posibles:
string[] items =
{
    "-- Select your favorite footwear --", "Sneakers", "Oxfords", "Flip-flops", "Other"
};

builder.InsertParagraph();
builder.InsertComboBox("My combo box", items, 0);

builder.Document.Save(ArtifactsDir + "DocumentBuilder.CreateForm.docx");

Ver también

DocumentBuilder.InsertCheckBox DocumentBuilder.InsertDocument