PdfAppearanceCharacteristics Class

The appearance characteristics of a widget annotation (/MK, ISO 32000-2, 12.5.6.19, table 192): what the library and the viewers use to draw the appearances of its field. The dictionary is created when a value is set.

public sealed class PdfAppearanceCharacteristics

Remarks

Changing a value does not change the appearances the widget already has: set the value of its field again, or call PdfAnnotation.UpdateAppearance for the widget of a text or a choice field.

Properties

NameDescription
BackgroundColorGets or sets the color of the background of the widget (/BG), or null for a transparent background.
BorderColorGets or sets the color of the border of the widget (/BC), or null for no border.
DownCaptionGets or sets the caption of a push button while it is pressed (/AC).
NormalCaptionGets or sets the caption of a push button (/CA), or the character of the symbol of a check box or a radio button in ZapfDingbats.
RolloverCaptionGets or sets the caption of a push button when the mouse is over it (/RC).
RotationGets or sets the rotation of the content of the widget, counterclockwise (/R): 0, 90, 180 or 270 degrees.

Gets or sets the color of the background of the widget (/BG), or null for a transparent background.

public PdfColor? BackgroundColor { get; set; }

Property value

PdfColor?

Gets or sets the color of the border of the widget (/BC), or null for no border.

public PdfColor? BorderColor { get; set; }

Property value

PdfColor?

Gets or sets the caption of a push button while it is pressed (/AC).

public string? DownCaption { get; set; }

Property value

string?

Gets or sets the caption of a push button (/CA), or the character of the symbol of a check box or a radio button in ZapfDingbats.

public string? NormalCaption { get; set; }

Property value

string?

Gets or sets the caption of a push button when the mouse is over it (/RC).

public string? RolloverCaption { get; set; }

Property value

string?

Gets or sets the rotation of the content of the widget, counterclockwise (/R): 0, 90, 180 or 270 degrees.

public int Rotation { get; set; }

Property value

int

Exceptions

ArgumentOutOfRangeException
The value is not a multiple of 90.