colorinfo

Records the colors used to draw the form when a user signs it. This option is only created if the user is allowing the operating system colors to override the color settings in the form. This is most common for users with vision disabilities who may set the operating system colors to provide better contrast between elements on the screen.

When the operating system colors override those set by the form itself, it is useful to create a record of those colors so that the appearance of the document, when signed, can be recreated.

Syntax

   <colorinfo>
      <color_name1>color</color_name1>
      ...
      <color_namen>color</color_namen>
   </colorinfo>
Table 1. colorinfo parameters
Parameter Type Description
color_name text The name of the operating system color. Possible color names include:
  • window – The color of the window displaying the form.
  • windowtext – The color of the text used in the form.
  • borderlight – The color of all three dimensional borders drawn on the form.
  • buttonshadow – The color used to draw the shadow on a button.
  • buttonface – The color used for to draw the face of a button.
  • buttontext – The color used to draw the text on a button.
color special The color may be expressed in any of the following formats:
  • Comma-separated RGB values. For example: 192,192,192
  • Hexadecimal-based RGB values. For example: #336699
  • Color name. For example: blue

Available in

signature

Example

When a user signs a form that is respecting the operating system color, a colorinfo block similar to the following is added to the signature item:

   <colorinfo>
      <window>255,255,255</window>
      <windowtext>0,0,0</windowtext>
      <borderlight>255,255,255</borderlight>
      <bordershadow>157,157,157</bordershadow>
      <buttonface>224,224,224</buttonface>
      <buttontext>0,0,0</buttontext> 
   </colorinfo>

Usage details

  1. Default: none