InsertComboBox

DocumentBuilder.InsertComboBox method

Fügt ein Combobox-Formularfeld an der aktuellen Position ein.

public FormField InsertComboBox(string name, string[] items, int selectedIndex)
ParameterTypBeschreibung
nameStringDer Name des Formularfelds. Kann eine leere Zeichenfolge sein. Der Wert, der länger als 20 Zeichen ist, wird abgeschnitten.
itemsString[]Die Elemente der ComboBox. Das Maximum beträgt 25 Artikel.
selectedIndexInt32Der Index des ausgewählten Elements in der ComboBox.

Rückgabewert

Der gerade eingefügte Formularfeldknoten.

Bemerkungen

Wenn Sie einen Namen für das Formularfeld angeben, wird automatisch ein Lesezeichen mit demselben Namen erstellt.

Beispiele

Zeigt, wie ein Kombinationsfeld-Formularfeld in ein Dokument eingefügt wird.

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

// Ein Formular einfügen, das den Benutzer auffordert, eines der Elemente aus dem Menü auszuwählen.
builder.Write("Pick a fruit: ");
string[] items = { "Apple", "Banana", "Cherry" };
builder.InsertComboBox("DropDown", items, 0);

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

Zeigt, wie Formularfelder erstellt werden.

DocumentBuilder builder = new DocumentBuilder();

// Formularfelder sind Objekte im Dokument, mit denen der Benutzer interagieren kann, indem er zur Eingabe von Werten aufgefordert wird.
// Wir können sie mit einem Document Builder erstellen. Im Folgenden finden Sie zwei Möglichkeiten, dies zu tun.
// 1 - Grundlegende Texteingabe:
builder.InsertTextInput("My text input", TextFormFieldType.Regular, 
    "", "Enter your name here", 30);

// 2 – Kombinationsfeld mit Eingabeaufforderungstext und einem Bereich möglicher Werte:
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");

Siehe auch

DocumentBuilder.InsertCheckBox DocumentBuilder.InsertDocument