InsertComboBox

DocumentBuilder.InsertComboBox method

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

public FormField InsertComboBox(string name, string[] items, int selectedIndex)
ParameterTypBeschreibung
nameStringDer Name des Formularfelds. Kann eine leere Zeichenfolge sein. Werte mit mehr als 20 Zeichen werden abgeschnitten.
itemsString[]Die Elemente der ComboBox. Maximal 25 Elemente.
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);

// Fügen Sie ein Formular ein, 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 Dokumentgenerator erstellen. Im Folgenden finden Sie zwei Möglichkeiten dazu.
// 1 - Einfache 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