Cell properties - General tab

General tab provides various options for Icon/Image control configuration.

Field

Description

Icon Source Select one of the following as the source for the icon/image:
  • Standard Icon: select from a list of icons pre-configured with a default icon, tooltip, and action.
  • Image
  • External URL
  • Property
  • Icon Class
Standard icon

Appears if you select Standard Icon as the Icon Source.

Press the down arrow and select the standard icon that you want to display. Standard icons are pre-configured with an icon and a tooltip. Variants of the pxIcon control are also configured with actions; see Standard icon controls for details.

External URL

Appears if you select External URL as the Icon Source.

Type the URL that you want to display as the icon/image source.

Image

Appears if you select Image as the Icon Source.

To search through binary file rules containing images, click the Gear icon to start the Image Catalog tool (a pop-up version of the Image Library landing page).

If the image is not already loaded to a binary file rule, create a binary file rule and upload the image to the binary file rule.

Image size

Appears if you select Image, External URL, or Property as the Icon Source. For images, this field displays only if the selected image is not a sprite (Treat Image As A Sprite is not selected on the Main tab of the image binary file.)

Select the image size:

  • Auto: automatically sizes the image by allowing the layout to determine the width of the control area. Default.
  • Custom: select to specify the width and height of the image in pixels in the Image dimension field.
Position

Appears if you select Image as the Icon Source and the selected image is a sprite. (Treat Image As A Sprite is selected on the Main tab of the image binary file.)

Sprites typically contain columns of images, representing each icon in normal, hover, and disabled states. Press the down arrow to select the column number of the image that you want to display.

Class

Appears if you select Icon Class as the Icon Source.

Specify the class of the icon.

Note: To learn how to upload your own icon fonts into an application, see the PDN video tutorial Implementing icons fonts in Pega applications.

Property

Appears if you select Property as the Icon Source.

Press the down arrow to select the property that you want to use as the source of the image/icon. The property can be an internal binary file (Rule-File-Binary) or an external URL.

Tooltip

Specify a tooltip to display when the user hovers the mouse pointer over the image or icon. You can press the down arrow to select a property value or type the text that you want to display as the tooltip.

As a best practice, start the sentence with verb either in the imperative ("Enter price of item here") or as an infinitive ("To cancel the order, click here").

Visibility Determine when the icon appears. The following visibility settings are available:
  • Always - the icon appearance is based on the visibility of the enclosing section or flow action when the form is first presented or is refreshed. This condition is checked only once.
  • Condition (expression)- specify the expression based on the comparison of a pair of constants, properties, or both, combined by Boolean operators, such as .Color="Red". You can combine the expression with a when condition rule or another expression. Click the gear icon to create an expression.
  • Condition (when rule) -specify the when rule that determines the visibility of this image or icon at runtime. Click the Open icon to review or create the when condition rule.
Run visibility condition on client

Appears when Visibility is set to Condition (expression) or Condition (when rule) and the expression corresponding to the visibility mode chosen has been entered.

Select to cause evaluation and execution of the condition each time the value of a property stated in the condition changes. If unselected, the expression is evaluated and the condition executed when the form is initially presented and whenever the form is refreshed.

Privilege

Press the down arrow to select a privilege rule that controls the availability of this control at runtime.

If there is a privilege and a when rule (see Disabled field), both rules must evaluate to true for the icon/image to be available to the user.

Disable

Select to disable the text input:

  • Never: never disabled
  • Always: always disabled
  • Condition (expression): the text input is disabled under the specified condition. In the field that displays, select a condition or click the Gear icon to open the Condition Builder. You can define a simple expression based on the comparison of a pair of constants, properties, or both, combined by Boolean operators, such as .Color="Red". You can combine the expression with a when condition rule or another expression using the && and || operators.
  • Condition (when): the text input is disabled under the specified condition. In the field that displays, select a when rule. Click the Open icon to create a new when condition or review an existing when condition.
Identifiers

In the Identifiers area, the following parameters are available:

  • Tour ID
  • Test ID
    Note: You can automatically generate a Test ID by clicking Generate ID.