Working with Push Buttons and Hyperlinks

In addition to the existing push buttons types used in classic applications, these toolbar action types are available for use in fluid applications only: Back, Clear Prompt, Help Link, Home, IN Prompt, Logout, Nav Bar, New Window, Search, Search Cancel, and SUOW Save.

You can create tool bars containing push buttons that appear in custom locations, such as sidebars for example, using your own actions, if needed. Push buttons are not required to appear only in the toolbar at the top of the page. Options that can be found on the Use tab that may also be of interest for fluid pages include:

  • Execute PC on Row\Group click: Runs PeopleCode as soon as user clicks on row\group).

  • Execute SearchSave Event: When a user runs a search, the system saves the page data prior to running the search so it is not lost. This option applies only to the search button, not every button on the page.

Note:

For a button to display an image and text (a combination button), on the Label tab, select Both for the Label Type, then specify the Alt tag for image and Label Image.

Note:

The Open in New Window and Replace Current Window options on the Push Button/Hyperlink Properties dialog box Use tab are not supported for fluid pages. To open a page in a new window for a fluid page, use PeopleCode, such as ViewURL or ViewContentURL.

Toggle Buttons

A toggle button is a two-state button indicating whether the button is pressed or not pressed (for example, on or off). Pressed (or on) means that the functionality implemented by the button is enabled. Not pressed (or off) means that the functionality implemented by the button is not enabled (or the default functionality is applied).

Toggle buttons can be created from simple text buttons (that is, a text button with the psc_button-simple style) or from image-only buttons. The toggle button states are manipulated by these toggle button methods of the PT_PAGE_UTILS:Utils class: PeopleCode API Reference: GetButtonState method: Utils class, PeopleCode API Reference: SetButtonState method: Utils class, and PeopleCode API Reference: ToggleButtonState method: Utils class.

For example, use the following code excerpt in a FieldChange PeopleCode program to toggle the button state each time the button is tapped:

import PT_PAGE_UTILS:*;

Local boolean &bState = (create PT_PAGE_UTILS:Utils()).ToggleButtonState(GetField());
/* Do additional processing associated with the toggle button. */

Transparent, Borderless Buttons

You can style push buttons to be transparent and borderless using the psc_button-transparent style. This style can be used on standard text buttons, text and image buttons, and image-only buttons. While this style can be used on simple buttons (that is, a button styled with psc_button-simple), it is not recommended. Do not use this style on primary buttons or on toggle buttons.

Related Topics