![image.field.properties.pane](image.field.properties.pane.png)
Figure 5. Image Field Tool, Push Button Properties Pane
The Push Button Properties pane can be used to determine a range of style and functionality options for image fields. For example, it is possible to use the Actions properties to add multiple dynamic actions to image fields, such as running JavaScript, launching web links and opening files on the local computer. (JavaScript is a high-level programming language that can be used to perform custom operations. See here for an index of existing JavaScript operations that the PDF-XChange Editor forms can use, as well as additional information about JavaScript).
The options detailed below are available for image fields:
The General properties determine the general parameters of image fields:
•Read Only determines whether or not the image field can be edited. •Locked determines whether or not image fields can be moved, and whether or not their properties can be modified. •Field Name determines the name of the image field. This name is present when the Edit Form tool is selected, and when image fields are listed in the Fields pane. •Tooltip determines the information displayed when the pointer is hovered over the image field. •Mapping Name determines the mapping name that the image field uses. This name is used to reference interactive form data when the form is exported, and does so without affecting the appearance of the name in the original document. •Orientation determines the orientation of the image field. •Visibility determines the visibility of the image field.
The Style properties determine stylistic elements of image fields. They are detailed beneath (figure 4).
The Position properties determine the position and dimensions of image fields:
•Left determines the distance of the image field from the left margin. •Top determines the distance of the image field from the bottom of the page. •Width/Height determine the width/height of the image field.
The Default Text Format properties are not applicable to image fields.
The Options properties determine additional options for image fields.
•Layout determines the layout of the image field, which can be displayed as text label, icon or a combination of both elements: •Label Only is the default setting for standard buttons. The text label that the Up Label property specifies is the only element displayed on the button. The Up Label property becomes available in the Options properties when Label Only setting is enabled. •Icon Only uses the custom image that the Up Icon property specifies to represent the button. The Up Label property becomes available in the Options properties when Icon Only setting is enabled. Image fields are set to Icon Only by default. •Icon Top, Label Bottom displays a custom image as the upper section of the button and the text label beneath the image. •Label Top, Icon Bottom displays the text label as the upper section of the button and a custom image beneath the text. •Icon Left, Label Right displays a custom image on the left and the text label on the right. •Label Left, Icon Right displays the text label on the left and a custom image on the right. •Label over Icon uses a custom image to represent the button and places the text label over the image.
![11.button.16](11.button.16.png)
![11.button.5](11.button.5.png)
Figure 6. Available Layout Options for Image Fields
•Behaviour specifies the visual effect when buttons are pressed: •None specifies that no visual change occurs. •Invert inverts the fill color of the button. •Outline creates an outline around the button. •Push creates a visual effect when buttons are clicked:
![11.selected.buttons](11.selected.buttons.png)
Figure 7. Default to Invert (Top), Default to Outline (Centre) and Default to Push (Bottom)
•Up Label specifies the text that the button uses. N.b. A Layout property that specifies a label must be enabled for the option to be available. •Up Icon specifies the icon that the button uses. N.b. A Layout property that specifies an icon must be enabled for the option to be available.
The Icon Placement properties determine settings for the icon used in the image field:
•When to Scale determines when icons are scaled to the size of the image field on which they are featured: •Always scales the icon to the size of the image field in all cases. •Scale Type determines how the icon is scaled: •Proportionally retains the aspect ratio of the icon •Non-proportionally ignores the aspect ratio of the icon. •Never retains the original size of the icon regardless of the size of the image field. •Icon is Too Big scales icons in cases where icons are larger than the image field. •Icon is Too Small scales icons in cases where icons are smaller than the image field. •Fit to Bounds fits the icon to the bounds of the image field. •Horizontal Position determines the horizontal position of the icon in the image field. •Vertical Position determines the vertical position of the icon in the image field.
The Actions properties determine the action taken when users interact with the image field:
•Mouse Down initiates an action when the left mouse button is pressed (without being released). •Mouse Up initiates an action when the left mouse button is clicked (pressed and released). •Mouse Enter initiates an action when the pointer moves into the image field. •Mouse Leave initiates an action when the pointer moves out of the image field. •On Focus initiates an action when the image field is selected. •On Blur initiates an action when the image field is deselected. •Click the ellipsis icon on the right of actions to add/edit image field actions:
![cb6](cb6.png)
Figure 8. Image Field Properties Pane, Action Ellipses
The process of adding actions is detailed here.
|