Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Specifying presentation options for a Button control

Updated on April 5, 2022

Three predefined formats are available for buttons: Strong, Standard, and Simple. Using these formats consistently in your application makes the user interface more predictable and makes it easier for users to complete forms.

  1. On the Presentation tab of the Properties panel, set the Control format option to one of the following settings to indicate the button's relative importance:

    • Strong – Use this format for the primary action on a form. Use it only once per view.
    • Standard – Use this format as a secondary style for navigation and actions.
    • Simple – Use this format to indicate an action.
    • Other – Use a custom format created in the Skin rule. Press the Down Arrow key in the adjacent field to select the custom format.
  2. To convert existing customized Button controls to a predefined format, use the pzUpdateButtonLinkFormats activity. For more information, see Update-Button-Link-Formats.

  3. To add a label to the Button control, select the Include a label check box and in the adjacent field enter the text for the label or press the Down Arrow key and select a predefined label.

  4. To specify a format for the label, press the Down Arrow key in the Label format field and select one.

  5. Set advanced presentation options.

    Instead of creating a new custom format in the skin, you can adjust elements in a cell by applying Cascading Style Sheet (CSS) helper classes. For example, you can use a CSS helper class to center an element in a cell or to double the standard right margin for the element.

    • Cell read-write classes – Click the Open helper class picker icon to specify one or more CSS helper classes to apply to this cell when the form is displayed in read-write mode. You can enter several helper classes, separated by a space. Alternatively, you can enter the name of a custom style to apply to this cell.
    • Cell read-only classes – Click the Open helper class picker icon to specify one or more CSS helper classes to apply to this cell when the form is displayed in read-only mode. You can enter several helper classes, separated by a space. Alternatively, you can enter the name of a custom style to apply to this cell.
    • Inline style (not for production use) – You can use this field to define an inline style by entering CSS code. However, entering an inline style results in a guardrail warning. For maintainability and reuse, the recommended approach is to use read-write or read-only classes.
    For more information, see CSShelper classes.

  • Button controls

    Use a Button control to enable users to take action on a form, such as submitting the form after filling it out.

  • Styling options for Button controls

    Establishing a consistent look for Button controls in your application saves development time, gives your application a more predictable user interface, and makes it easier for users to complete forms.

  • Adding and configuring a Button control

    By adding a Button control to a layout, you make it possible for application users to complete a task, such as submitting a form after completing its fields. By configuring a Button control, you give your application a consistent look and feel.

  • Specifying the caption for a Button control

    Using a caption for a Button control makes it easier for application users to understand the button's purpose and to complete their tasks.

  • Specifying the image source and tooltip for a Button control

    Using images and tooltips to indicate a button's purpose makes it easier for application users to understand a form and to complete their tasks.

  • Defining the behavior of form elements

    Ensure that users see and complete only the fields that are relevant to the processing of a case by defining the rules that govern the behavior of form elements.

  • Copying, moving, or deleting a control

    You can use basic Windows operations to speed the development of your controls.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us