InsertTextInput

DocumentBuilder.InsertTextInput method

Fügt ein Textformularfeld an der aktuellen Position ein.

public FormField InsertTextInput(string name, TextFormFieldType type, string format, 
    string fieldValue, int maxLength)

Parameter	Typ	Beschreibung
name	String	Der Name des Formularfelds. Kann eine leere Zeichenfolge sein.
type	TextFormFieldType	Gibt den Typ des Textformularfelds an.
format	String	Formatzeichenfolge, die zum Formatieren des Werts des Formularfelds verwendet wird.
fieldValue	String	Text, der im Feld angezeigt wird.
maxLength	Int32	Maximale Länge, die der Benutzer in das Formularfeld eingeben kann. Für unbegrenzte Länge auf Null setzen.

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 Texteingabeformularfeld in ein Dokument eingefügt wird.

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

// Ein Formular einfügen, das den Benutzer zur Texteingabe auffordert.
builder.InsertTextInput("TextInput", TextFormFieldType.Regular, "", "Enter your text here", 0);

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

Zeigt, wie ein Texteingabeformularfeld eingefügt wird.

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

builder.Write("Please enter text here: ");

// Ein Texteingabefeld einfügen, das es dem Benutzer ermöglicht, darauf zu klicken und Text einzugeben.
// Weisen Sie einen Platzhaltertext zu, den der Benutzer überschreiben und übergeben kann
// eine maximale Textlänge von 0, um keine Begrenzung für den Inhalt des Formularfelds anzuwenden.
builder.InsertTextInput("TextInput1", TextFormFieldType.Regular, "", "Placeholder text", 0);

// Das Formularfeld wird in Form eines „Eingabe“-HTML-Tags mit dem Typ „Text“ angezeigt.
doc.Save(ArtifactsDir + "FormFields.TextInput.html");

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.InsertTableOfContents DocumentBuilder.MoveTo