Dynamic Appearance Properties
Some Widgets are visualizing variable content, which should be dynamically reconstructed after each field value change. In order to define the way this content is evaluated, all widgets provide two type of properties – VariableTextProperties defining the text specific properties and DynamicAppearanceCharacteristics defining the geometry specific properties. This article describes these two types.
VariableTextProperties Class
This class is used by Widget annotations to specify the properties needed for the dynamic construction widget text. An instance of this class may also be found in the FormField class, proving easy way to ensure that all widgets created from this field will use similar text properties.
These properties are as follows:
| Property | Description |
|---|---|
HorizontalAlignment | Gets or sets the text horizontal alignment. |
CharacterSpacing | Gets or sets the character spacing. |
WordSpacing | Gets or sets the word spacing. |
HorizontalScaling | Gets or sets the text horizontal scaling. |
Font | Gets or sets the font. |
FontSize | Gets or sets the font size. If zero, the size is automatically calculated to fit the available space in the widget annotation rectangle. |
TextRise | Gets or sets the text rise. |
RenderingMode | Gets or sets the text rendering mode. |
Fill | Gets or sets the text fill color. |
Stroke | Gets or sets the text stroke color. |
StrokeThickness | Gets or sets the text stroke thickness. |
StrokeLineCap | Gets or sets the text stroke line cap. |
StrokeLineJoin | Gets or sets the text stroke line join. |
StrokeDashArray | Gets or sets the text stroke dash array. |
StrokeDashOffset | Gets or sets the text stroke dash offset. |
MilterLimit | Gets or sets the text miter limit. |
In .NET Standard/.NET (Target OS: None) environments, fonts beyond the 14 standard ones require a FontsProvider implementation to be resolved correctly.
DynamicAppearanceCharacteristics Class
This class is used by VariableContentWidget and SignatureWidget classes in order to specify the dynamic construction of widget geometry representation. It provides the following properties:
| Property | Description |
|---|---|
Rotation | Gets or sets the rotation of the widget content. |
BorderColor | Gets or sets the color of the Widget rectangle border. If null, no border is drawn. Takes effect only when an AnnotationBorder is set to the widget's Border property. |
Background | Gets or sets the color of the Widget rectangle background. If null, no background is drawn. |
ButtonAppearanceCharacteristics Class
This class inherits DynamicAppearanceChanacteristics and is used by TwoStateButtonWidget and RadioButtonWidget for dynamically constructing button appearances. It adds the following property to its parent class implementation:
| Property | Description |
|---|---|
NormalCaption | The text drawn when the mouse is not interacting with the button. |
PushButtonAppearanceCharacteristics Class
This class inherits ButtonAppearanceCharacteristics and is used by PushButtonWidget for dynamically constructing button appearances. It adds the following properties to its parent class implementation:
| Property | Description |
|---|---|
MouseOverCaption | The text drawn when the mouse is over the button. |
MouseDownCaption | The text drawn when the mouse is pressed on the button. |
NormalIconSource | FormSource used for drawing a button icon when the mouse is not interacting with the widget. |
MouseOverIcon | FormSource used for drawing a button icon when the mouse is over the widget. |
MouseDownIcon | FormSource used for drawing a button icon when the mouse is pressed on the widget. |
IconAndCaptionPosition | Specifies how to position the button icon relative to the button caption. |
IconFitOptions | Provides options specifying how to position and whether or how to scale the icon within the available space in the annotation rectangle. |