Skip to main content


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

Specifying presentation options for an Icon control

Updated on November 15, 2021
Applicable to Theme UI-Kit applications

After you create the Image control, configure how the control is displayed. You can specify whether the Icon control has a label and what happens when an application user clicks or taps the icon.

Prerequisite: Add an Icon control to a layout.

  1. Optional: To add a label to the icon, select the Include a label check box on the Presentation tab of the Properties panel and in the adjacent field enter the text for the label or press the Down Arrow key and select a predefined label.
  2. Optional: To specify a format for the label, press the Down Arrow key in the Label format field and select one.
  3. In the Type field, select one of the following settings to determine what happens when a user clicks or taps the icon at run time:
    • URL – Launches the URL that you specify in the adjacent field.
    • Email – Opens the email composer and uses the text that you enter in the adjacent field in the To: field of the email message.
    • Phone – Opens the phone dialer or another configured phone application.
  4. Optional: 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 CSS helper classes.

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