PDFsharp-net6

PdfListBoxField

Namespace: PdfSharp.Pdf.AcroForms

Represents the list box field.

public sealed class PdfListBoxField : PdfChoiceField, System.ICloneable, System.Collections.Generic.IEnumerable`1[[System.Collections.Generic.KeyValuePair`2[[System.String, System.Private.CoreLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e],[PdfSharp.Pdf.PdfItem, PdfSharp, Version=0.1.3.0, Culture=neutral, PublicKeyToken=null]], System.Private.CoreLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]], System.Collections.IEnumerable

Inheritance ObjectPdfItemPdfObjectPdfDictionaryPdfAcroFieldPdfChoiceFieldPdfListBoxField
Implements ICloneable, IEnumerable<KeyValuePair<String, PdfItem>>, IEnumerable

Properties

SelectedIndices

Gets or sets the Indices of the selected items of this Field

public IEnumerable<int> SelectedIndices { get; set; }

Property Value

IEnumerable<Int32>

HighlightColor

Gets or sets the background color for selected items of the field.

public XColor HighlightColor { get; set; }

Property Value

XColor

HighlightTextColor

Gets or sets the text-color for selected items of the field.

public XColor HighlightTextColor { get; set; }

Property Value

XColor

Value

Gets or sets the value for this ListBox
Note: As a PdfListBoxField may have multiple values selected, this is an enumerable instead of a single value

public IEnumerable<string> Value { get; set; }

Property Value

IEnumerable<String>

TopIndex

Gets or sets the index of the first visible item in the ListBox

public int TopIndex { get; set; }

Property Value

Int32

Value

Gets or sets the Value for the Field. For fields supporting multiple values (e.g. ListBox) use PdfListBoxField.SelectedIndices instead

public PdfItem Value { get; set; }

Property Value

PdfItem

DefaultValue

Gets or sets the Default value for the field

public PdfItem DefaultValue { get; set; }

Property Value

PdfItem

Options

Gets or sets the List of options (entries) available for selection. This is the list of values shown in the UI.

public ICollection<string> Options { get; set; }

Property Value

ICollection<String>

Values

Gets the list of values for this Field.
May or may not be equal to PdfChoiceField.Options but has always the same amount of items.

public ICollection<string> Values { get; }

Property Value

ICollection<String>

Name

Gets the name of this field.

public string Name { get; set; }

Property Value

String

AlternateName

Gets the alternative Name of the Field (/TU)

public string AlternateName { get; set; }

Property Value

String

MappingName

Gets the mapping Name of the Field (/TM)

public string MappingName { get; set; }

Property Value

String

FullyQualifiedName

Gets the fully qualified name of this field, that is: “parent-name.field-name”

If the field has no parent, this is equal to PdfAcroField.Name

public string FullyQualifiedName { get; }

Property Value

String

Parent

Gets the Parent of this field or null, if the field has no parent

public PdfAcroField Parent { get; internal set; }

Property Value

PdfAcroField

Flags

Gets the field flags of this instance.

public PdfAcroFieldFlags Flags { get; }

Property Value

PdfAcroFieldFlags

Font

Gets or sets the font used to draw the text of the field.

public XFont Font { get; set; }

Property Value

XFont

DeterminedFontSize

Gets the font size that was obtained by analyzing the Fields’ content-stream.

public double DeterminedFontSize { get; internal set; }

Property Value

Double

ForeColor

Gets or sets the foreground color of the field.

public XColor ForeColor { get; set; }

Property Value

XColor

TextAlign

Gets or sets the alignment for the text of this field.

public TextAlignment TextAlign { get; set; }

Property Value

TextAlignment

ReadOnly

Gets or sets a value indicating whether the field is read only.

public bool ReadOnly { get; set; }

Property Value

Boolean

Item

public PdfAcroField Item { get; }

Property Value

PdfAcroField

HasKids

Indicates whether the field has child fields and/or annotations.

public bool HasKids { get; }

Property Value

Boolean

HasChildFields

Indicates whether the field has child fields.

public bool HasChildFields { get; }

Property Value

Boolean

DescendantNames

Caution

Use GetDescendantNames


Gets the names of all descendants of this field.

public String[] DescendantNames { get; }

Property Value

String[]

Fields

Gets the collection of fields within this field.

public PdfAcroFieldCollection Fields { get; }

Property Value

PdfAcroFieldCollection

Annotations

Gets the annotations for this field. The elements in this list are of type PdfWidgetAnnotation.

public PdfAnnotationArray Annotations { get; }

Property Value

PdfAnnotationArray

Elements

Gets the dictionary containing the elements of this dictionary.

public DictionaryElements Elements { get; }

Property Value

DictionaryElements

Stream

Gets or sets the PDF stream belonging to this dictionary. Returns null if the dictionary has no stream. To create the stream, call the CreateStream function.

public PdfStream Stream { get; set; }

Property Value

PdfStream

Owner

Gets the PdfDocument this object belongs to.

public PdfDocument Owner { get; }

Property Value

PdfDocument

IsIndirect

Indicates whether the object is an indirect object.

public bool IsIndirect { get; }

Property Value

Boolean

Internals

Gets the PdfInternals object of this document, that grants access to some internal structures which are not part of the public interface of PdfDocument.

public PdfObjectInternals Internals { get; }

Property Value

PdfObjectInternals

Reference

Gets the indirect reference of this object. If the value is null, this object is a direct object.

public PdfReference Reference { get; internal set; }

Property Value

PdfReference

ReferenceNotNull

Gets the indirect reference of this object. Throws if it is null.

public PdfReference ReferenceNotNull { get; }

Property Value

PdfReference

Exceptions

InvalidOperationException
The indirect reference must be not null here.

Methods

RenderAppearance()

Renders the appearance of this field

protected void RenderAppearance()

PrepareForSave()

internal void PrepareForSave()