Form Button

Xodo PDF Studio is capable of creating Push Buttons. Push Buttons allow you to create custom buttons on the PDF document that will perform an action when pressed. Xodo PDF Studio does include some basic actions that can be added without any coding required. For more advanced options you can program the actions using JavaScript. You will need to have advance knowledge in programming JavaScript in order to create the actions for the buttons. For more information regarding JavaScript in Xodo PDF Studio see Supported JavaScript in PDFStudio

 

Creating Buttons

  1. Start the Form Editing Mode by going to the Forms Tab
  2. Click on the Button button located on the tool bar. The cursor will then change to show a preview of the field
  3. Using the mouse move to the location you want to place the field and then click to place the field or click and drag to create a custom field size.
  4. The Button Properties dialog will then be displayed so that you can add the action to the button as it will initially do nothing.
  5. Click on the Actions tab
  6. Click on Add to create an action for the button. See Form Field Actions for a list of available actions and their options
  7. Once the actions have been added click on OK to set the actions
  8. Repeat steps 1-7 to create as many Buttons as you need
  9. To finish placing Buttons press Esc or click on the button on the toolbar

Button Properties

To access the Button properties right click (Mac: Ctrl + Click) on the field and choose Properties in the mouse menu or click on the edit button on the Mini Toolbar. The Button contains the following property settings.

Appearance

Name - The Button field

Tooltip - The tip that is shown when the mouse is hovered over the field

Style

Font - Sets the font of the text on the button

Size - Sets the font size of the text on the button

Text Color - Sets the text color on the button

Border Color - Sets the color of the border on the button

Line Width - Sets the width of the border line on the button

Fill Color - Sets the fill color on the button

Style - Sets the style for the border line (i.e. dotted, dashed, cloud, etc...) on the button

Save as default - When checked this will make the selected style settings the default for any new Buttons going forward

Properties

Rotation - Sets the field rotation in 90 degree increments

Required - This option is not available on Buttons

Visibility - Sets one of four visibility options for the field

      • Show: the default setting makes the field visible
      • Hide: hides the field from being displayed when viewing the document
      • Show/Do not print: shows the field but will not print the field or it's values
      • Hide/Print: hides the field but the field and its value will be printed

Read Only - Makes the field uneditable and will just display the value currently set in the field

Locked - When checked prevents the following on the field: being moved or resized, editing appearance properties, & deleting the annotation.

Options

Style - Sets the style of the Button

    • None: The button will have no effect when pushed
    • Invert: The entire button will highlight when pressed
    • Outline: Only the outline of the button will be highlighted when pressed. Change to a larger line width to see it more
    • Push: Allows you to define separate labels for each of the below interactions with the button
      • Up: when the button is not being acted on
      • Down: when the button is pressed
      • Mouse Over: When the mouse is hovered over the button

Label - Sets whether the button has a label and it's location

Image - Sets whether the button has an image in the background and it's location

Note: Any of the supported image formats (JPEG, PNG, GIF, & TIFF) or a PDF document can be set as the image on the button

Actions

The Action Panel displays a list of the current actions associated with the field. Actions can be added, edited, or deleted using the buttons below the actions list.

Add - Adds a custom Form Field Actions from a list of available actions.

Edit - Edits the currently selected action from the list

Remove -  Removes the currently selected action from the list