Button

Button adds a clickable and customizable object to a form. Its role is to activate various actions.

Source

Connected data source is the dynamic data source that is connected with the object.

• Fixed data: manually entered fixed text.

• Variables: predefined variable values which are used as object content.

• Functions: input data transformation tools.

• Databases: database values which are used as object content.

Content field is used for entering the object content.

Settings

Keyboard shortcut defines any keyboard to act as a shortcut. If the defined keyboard key is pressed, it acts as if the user would use a mouse click for running an action.

Default form button invokes the assigned action when a user presses Enter.

Word wrap divides the text into multiple lines. It makes sure the text is not wider than the button.

Use a picture on the button group defines a graphic file to be displayed on a button.

• Picture file name: graphic file selected to be used on a button.

• Embed picture in a document: picture embedded in the document.

  Tip

  Whenever an embedded picture is needed, it is retrieved from the document and not from the file system.

• Save embedded picture to file: embedded picture is saved to a file.

• Remove embedded picture: embedded picture is removed from the form document.

  Tip

  If the picture is embedded, this action enables saving it at a selected location. The picture is no longer embedded.

• Picture position: picture position in relation to the object text.

• Force original size: full-size graphic without resizing is used on a button.

Style

Style tab defines visual appearance of an object.

Background color defines the object background color.

• Transparent: transparent object background.

Font color defines the font and underline colors.

Font selects the typeface.

The font may appear Bold, Italic, Underlined or as a Strikethrough text.

Alignment defines horizontal positioning of the entered content.

• Left: text aligned with the left object border.

• Center: text positioned centrally.

• Right: text aligned with the right object border.

Position

Position tab defines object positioning and its position-related behavior.

Position group defines the object position.

• X and Y: anchoring point coordinates.

• Width and Height: horizontal and vertical object dimension.

• Keep aspect ratio: simultaneous changing of object dimensions while scaling.

• Lock: prevents the object from being moved during the design process.

Size group sets how object's dimensions change when the form is running:

• Resize anchor point: defines the fixed distance of an object from the form borders.

  Tip

  Choose the most appropriate anchor point to ensure the object's visibility regardless of the current window size.

• Horizontally resize with form and Vertically resize with form: object size automatically adapts to the changing size of the form.

  • Horizontally resize with form: object width adapts to the resized form.

  • Vertically resize with form: object height adapts to the resized form.

    Note

    If both options are enabled, object width and height adapt to the resized form simultaneously.

Rotation angle group sets the object angle according to the design surface.

Events

Events tab defines the actions that are run by various object-related events.

Available events for button object is:

• On Click: action is run on mouse click.

General

General tab identifies the object and defines object state on form startup.

Name sets a unique object ID. It is used for object referencing when defining functions, variables, scripts, etc.

Description allows adding notes and annotations for an object.

Hint (tooltip) helps the form users by briefly explaining why or how to use an object. Hint is shown to a user when the mouse pointer floats over the selected object.

Initial state on form startup group defines the object behavior when the form is run for the first time:

• Enabled: defines if the object is going to be active (editable) at form startup or not.

  • Condition: an object is enabled if the result of the given condition is "True".

• Visible: defines if the selected object is going to appear on the form or not.

  • Condition: an object is visible if the result of the given condition is "True".