FieldFillIn

FieldFillIn class

Implementerar FILLIN-fältet.

För att lära dig mer, besökArbeta med fält dokumentationsartikel.

public class FieldFillIn : Field

Konstruktörer

namnBeskrivning
FieldFillIn()Default_Constructor

Egenskaper

namnBeskrivning
DefaultResponse { get; set; }Hämtar eller ställer in standardanvändarsvar (initialvärde som finns i promptfönstret).
DisplayResult { get; }Hämtar texten som representerar det visade fältresultatet.
End { get; }Hämtar noden som representerar fältets slut.
Format { get; }Får enFieldFormatobjekt som ger typad åtkomst till fältets formatering.
IsDirty { get; set; }Hämtar eller anger om det aktuella resultatet av fältet inte längre är korrekt (inaktuellt) på grund av andra ändringar som gjorts i dokumentet.
IsLocked { get; set; }Hämtar eller anger om fältet är låst (resultatet ska inte beräknas om).
LocaleId { get; set; }Hämtar eller ställer in fältets LCID.
PromptOnceOnMailMerge { get; set; }Hämtar eller anger om användarsvaret ska tas emot en gång per dokumentkopplingsoperation.
PromptText { get; set; }Hämtar eller ställer in prompttexten (titeln på promptfönstret).
Result { get; set; }Hämtar eller anger text som är mellan fältavgränsaren och fältslutet.
Separator { get; }Hämtar noden som representerar fältseparatorn. Kan varanull .
Start { get; }Hämtar noden som representerar början av fältet.
virtual Type { get; }Hämtar fälttypen Microsoft Word.

Metoder

namnBeskrivning
GetFieldCode()Returnerar text mellan fältstart och fältavgränsare (eller fältslut om det inte finns någon avgränsare). Både fältkod och fältresultat för underfält inkluderas.
GetFieldCode(bool)Returnerar text mellan fältstart och fältavgränsare (eller fältslut om det inte finns någon avgränsare).
Remove()Tar bort fältet från dokumentet. Returnerar en nod direkt efter fältet. Om fältets slut är den sista undernoden till dess överordnade nod, returneras dess överordnade stycke. Om fältet redan är borttaget returnerasnull .
Unlink()Utför fältavkopplingen.
Update()Utför fältuppdateringen. Körs om fältet redan uppdateras.
Update(bool)Utför en fältuppdatering. Körs om fältet redan uppdateras.

Anmärkningar

Uppmanar användaren att ange text.

Exempel

Visar hur man använder FILLIN-fältet för att uppmana användaren att svara.

public void FieldFillIn()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    // Infoga ett FILLIN-fält. När vi manuellt uppdaterar detta fält i Microsoft Word,
    // det kommer att uppmana oss att ange ett svar. Fältet kommer sedan att visa svaret som text.
    FieldFillIn field = (FieldFillIn)builder.InsertField(FieldType.FieldFillIn, true);
    field.PromptText = "Please enter a response:";
    field.DefaultResponse = "A default response.";

    // Vi kan också använda dessa fält för att be användaren om ett unikt svar för varje sida
    // skapades under en dokumentkoppling som gjordes med Microsoft Word.
    field.PromptOnceOnMailMerge = true;

    Assert.AreEqual(" FILLIN  \"Please enter a response:\" \\d \"A default response.\" \\o", field.GetFieldCode());

    FieldMergeField mergeField = (FieldMergeField)builder.InsertField(FieldType.FieldMergeField, true);
    mergeField.FieldName = "MergeField";

    // Om vi utför en dokumentkoppling programmatiskt kan vi använda en anpassad promptsvarare
    // för att automatiskt redigera svar för FILLIN-fält som dokumentkopplingen stöter på.
    doc.FieldOptions.UserPromptRespondent = new PromptRespondent();
    doc.MailMerge.Execute(new [] { "MergeField" }, new object[] { "" });

    doc.UpdateFields();
    doc.Save(ArtifactsDir + "Field.FILLIN.docx");
}

/// <summary>
/// Lägger till en rad före standardsvaret för varje FILLIN-fält under en dokumentkoppling.
/// </summary>
private class PromptRespondent : IFieldUserPromptRespondent
{
    public string Respond(string promptText, string defaultResponse)
    {
        return "Response modified by PromptRespondent. " + defaultResponse;
    }
}

Se även

FieldFileSize Class FieldFootnoteRef Class