ImageGear .NET - Updated
Modify Field Appearance
User Guide > How to Work with... > Formats with Additional Functionality > PDF > How to... > Work with PDF Forms > Modify Field Appearance

The Acrofroms API supports changing visual properties of fields, such as color, border, and text information. These are properties of the Field and WidgetAnnotation.

Widget Border and Fill Properties

The visual appearance of a widget annotation can be changed through the BorderStyleBorderColorBorderWidth and FillColor properties of a widget annotation.

A BorderWidth of 0 will result in no border being drawn. A BorderStyle of SOLID will be returned as the default for fields with no border. A border of INSET is initially applied to RadioGroup fields created by ImageGear.

Example border styles:

 

C# Example
Copy Code
void ModifyWidgetProperties(Field field)
{
    foreach(WidgetAnnotation widget in field.Widgets)
    {
        // Set some fill and border colors.
        widget.FillColor = Color.Red;
        widget.BorderColor = Color.YellowGreen;
 
        // Set a thick border width (size 3).
        // Any integer can also be used.
        widget.BorderWidth = AnnotationBorderWidth.THICK;
 
        // Set a border style.
        widget.BorderStyle = AnnotationBorderStyle.DASHED;
    }
}

Field Text Properties and Fonts

Fields with variable text have the ability to modify the FontNameFontSize, and TextColor of the displayed textual value.

The variable text fields are TextFieldListBoxComboBox, and PushButton. Setting these properties for other fields will have no effect.

Example FontName, FontSize, and TextColor applications to TextField:

C# Example
Copy Code
void ModifyTextProperties(TextField field)
{
    // Set some font settings.
    field.FontName = "Helvetica";
    field.FontSize = 22;
 
    // Color the text.
    field.TextColor = Color.BlanchedAlmond;
}