InsertCheckBox

InsertCheckBox(string, bool, int)

Fügt an der aktuellen Position ein Kontrollkästchen-Formularfeld ein.

public FormField InsertCheckBox(string name, bool checkedValue, int size)
ParameterTypBeschreibung
nameStringDer Name des Formularfelds. Kann eine leere Zeichenfolge sein. Werte mit mehr als 20 Zeichen werden abgeschnitten.
checkedValueBooleanÜberprüfter Status des Kontrollkästchen-Formularfelds.
sizeInt32Gibt die Größe des Kontrollkästchens in Punkt an. Geben Sie 0 für MS Word an, um die Größe des Kontrollkästchens automatisch zu berechnen.

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 Kontrollkästchen in das Dokument eingefügt werden.

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

// Kontrollkästchen unterschiedlicher Größe und mit standardmäßig aktiviertem Status einfügen.
builder.Write("Unchecked check box of a default size: ");
builder.InsertCheckBox(string.Empty, false, false, 0);
builder.InsertParagraph();

builder.Write("Large checked check box: ");
builder.InsertCheckBox("CheckBox_Default", true, true, 50);
builder.InsertParagraph();

// Die Namenslänge von Formularfeldern ist auf 20 Zeichen begrenzt.
builder.Write("Very large checked check box: ");
builder.InsertCheckBox("CheckBox_OnlyCheckedValue", true, 100);

Assert.AreEqual("CheckBox_OnlyChecked", doc.Range.FormFields[2].Name);

// Wir können mit diesen Kontrollkästchen in Microsoft Word interagieren, indem wir darauf doppelklicken.
doc.Save(ArtifactsDir + "DocumentBuilder.InsertCheckBox.docx");

Siehe auch


InsertCheckBox(string, bool, bool, int)

Fügt an der aktuellen Position ein Kontrollkästchen-Formularfeld ein.

public FormField InsertCheckBox(string name, bool defaultValue, bool checkedValue, int size)
ParameterTypBeschreibung
nameStringDer Name des Formularfelds. Kann eine leere Zeichenfolge sein. Werte mit mehr als 20 Zeichen werden abgeschnitten.
defaultValueBooleanStandardwert des Kontrollkästchen-Formularfelds.
checkedValueBooleanAktueller aktivierter Status des Kontrollkästchen-Formularfelds.
sizeInt32Gibt die Größe des Kontrollkästchens in Punkt an. Geben Sie 0 für MS Word an, um die Größe des Kontrollkästchens automatisch zu berechnen.

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 Kontrollkästchen in das Dokument eingefügt werden.

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

// Kontrollkästchen unterschiedlicher Größe und mit standardmäßig aktiviertem Status einfügen.
builder.Write("Unchecked check box of a default size: ");
builder.InsertCheckBox(string.Empty, false, false, 0);
builder.InsertParagraph();

builder.Write("Large checked check box: ");
builder.InsertCheckBox("CheckBox_Default", true, true, 50);
builder.InsertParagraph();

// Die Namenslänge von Formularfeldern ist auf 20 Zeichen begrenzt.
builder.Write("Very large checked check box: ");
builder.InsertCheckBox("CheckBox_OnlyCheckedValue", true, 100);

Assert.AreEqual("CheckBox_OnlyChecked", doc.Range.FormFields[2].Name);

// Wir können mit diesen Kontrollkästchen in Microsoft Word interagieren, indem wir darauf doppelklicken.
doc.Save(ArtifactsDir + "DocumentBuilder.InsertCheckBox.docx");

Siehe auch