InsertCheckBox

InsertCheckBox(string, bool, int)

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

public FormField InsertCheckBox(string name, bool checkedValue, int size)
ParameterTypBeschreibung
nameStringDer Name des Formularfelds. Kann eine leere Zeichenfolge sein. Der Wert, der länger als 20 Zeichen ist, wird abgeschnitten.
checkedValueBooleanÜberprüfter Status des Kontrollkästchen-Formularfelds.
sizeInt32Gibt die Größe des Kontrollkästchens in Punkten 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 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();

// Formularfelder haben eine Namenslängenbeschränkung von 20 Zeichen.
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 ein Kontrollkästchen-Formularfeld an der aktuellen Position ein.

public FormField InsertCheckBox(string name, bool defaultValue, bool checkedValue, int size)
ParameterTypBeschreibung
nameStringDer Name des Formularfelds. Kann eine leere Zeichenfolge sein. Der Wert, der länger als 20 Zeichen ist, wird abgeschnitten.
defaultValueBooleanStandardwert des Kontrollkästchen-Formularfelds.
checkedValueBooleanAktueller Prüfstatus des Kontrollkästchen-Formularfelds.
sizeInt32Gibt die Größe des Kontrollkästchens in Punkten 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 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();

// Formularfelder haben eine Namenslängenbeschränkung von 20 Zeichen.
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