Command buttons

To insert a command button, click Command Button on the Object toolbar.

To specify the behavior of the button, right-click and select Format Button. Specify the options of the General tab.

To format a button, see Formatting command buttons.

General tab

This table shows the options of the General tab.

Option Description
Name By default, command buttons are named ButtonN, where N is a sequential number. You can specify a different name.
Caption Specify a label for the button in the Text field. The label will not be added to the Table of Names and Texts.

See Specifying the language.

To select a text from the translation table, or to create a translatable name, click the button adjacent to the Text field. The Texts dialog is displayed.
Note: In View Mode, if the caption is too long for the button, both the beginning and end of the text are trimmed. But, in Application Studio WebServices only the end of the text is trimmed.
Tooltip Specify text to display as a tooltip in Application Studio WebServices.
Click action

You can specify an action to execute when the button is clicked.

  • No function (for scripting). No action is assigned to the command button. It is available for scripting.
  • Recalculate report. The report recalculates.
  • Open the Pick List Manager. Click the adjacent button to open the Pick List Manager and specify a pick list. This option is enabled only if the report contains a list. In View Mode, click the button to open the pick list.

    See (Pick lists)

  • Execute an action after click. Click the adjacent button to open the Edit Action dialog and specify an action. In View Mode, clicking the button executes the action.

    See Actions

Writeback You can specify that a button will action writeback of data in Application Studio WebServices.

Size and Position tab

See Size and Position tab.

The Properties tab

The Properties tab lists the properties of the button (for example, background color and font). The tab has two sections: Custom and Style.

By default, True is selected as the value of the Enabled option in the Style section. You can edit the object in Design Mode and use it in View Mode. If you select False, the object cannot be edited. It remains visible in View Mode but cannot be used. To revert to True, you must first switch to design mode by clicking Design Mode in the Objects toolbar.

By default, the options of the Custom section are disabled. They are enabled if Custom is selected as the value of the Style in Full Client or of the Style in Web option.

By default, Native Windows is selected as the value of Style in Full Client property. To specify custom properties, select Custom.

This table shows the Style in Web options:

Option Description
Infor Standard Button

Background darkens on hover

Infor Highlighted Button (Blue)

Background darkens on hover

Infor Toolbar Button

Background darkens on hover

Native Windows Button

Background lightens on hover

Custom Specify custom values for font, background color etc.
Note: The differences between the button styles are not visible in the full client.

Image and Picture Hotspot

You can display an image on a command button and, if required, a second image to display when the cursor hovers over the button.

To display an image on a command button, Click the Image field and browse to a file or select a shared image. The image must be in one of these formats:

  • .bmp
  • .jpg
  • .jpeg
  • .wmf

Fit image to button size

You can specify how the image, and hover image, should fit within the dimensions of the button.

To display a hover image, click the Picture hotspot field and select an image.

The image sizing options are:

Fit to
The image expands or contracts to the shortest dimension of the button. The image does not distort because its height to width ratio does not change.
Example:
Dimensions
Button Original image Resized image
Height (cms) 1 0.5 1
Width (cms) 4 0.5 1
Keep picture size
The size of the image does not change. If the image is larger than the button, the button is filled with part of the image.
Fit to both directions
The image expands or contracts to fill the button. This can distort the image if, for example, the height to width ratio of the button is different from the height to width ratio of the image.
Fit horizontally
The image expands or contracts horizontally to the width of the button. In both cases, the image distorts. If the height and width of the image are greater than the height and width of the button, the button is filled by the image. But the image contracts so that its full width is displayed on the button.
Fit vertically
The image expands or contracts vertically to the height of the button. In both cases, the image distorts. If the height and width of the image are greater than the height and width of the button, the button is filled by the image. But the image contracts so that its full height is displayed on the button.
Note: In all cases, the center of the image is aligned with the center of the button. The Horizontal and Vertical alignment options only directly affect the alignment of text on the button. But both can indirectly affect the size and position of an image if both text and image are displayed.

Horizontal alignment, Vertical alignment, and Text position

By default, if text is displayed on a button it is aligned at the center of the button. If Custom is selected as the value of the Style in Full Client or of the Style in Web option, you can change the horizontal and vertical alignment of the text. For example, you might display the text at the top right of the button.

If the button displays both text and an image, you can specify either Through or Next To as the value of the Text position option. Through specifies that text is displayed on the image. Next To specifies that the text is displayed to the left or right of the image, or below or above it, according to the horizontal and vertical alignment options selected. The image is moved and, if necessary, resized to accommodate the text.
Note: If Center is the value of both Horizontal and Vertical alignment options, Through is selected and the Text position option disabled.

Margins

If text is displayed on a button, the Left, Right, Top, and Bottom margin options specify its distance from the edges of the button. By default, text is 2 pixels from each edge. To specify different margins, click the arrow to the left of the Margins option to display the margins and their values. Specify new values.

Availability tab

See Availability tab.