Picture Control

The Picture control is a read-only display control that allows you to display static images.

  1. Create a view.
  2. Drag the control onto the canvas. You can find the control in the Display section of the Toolbox.
  3. Add a source to your control. To do this, configure the Source under the Data Source of the Properties section.
  4. Configure the rest of the properties as required.
  5. Run the view.

When you click on the ellipsis next to Data Source > Source in the control's Properties, the Select a Picture page opens. You can use pictures to display from the list or upload your own pictures. On this page you can add, edit, and delete pictures. However, be careful when you do this because you can edit or delete pictures that other people have uploaded.

When you click Add the Upload a Picture page opens. Add pictures using this dialog.

You can find the control in the Display section of the Toolbox.

Properties Description Can be set in runtime using rules?
Detail
Name A unique identifier for the control. This property is required and defaults to the name of the control. No
Alternate Text The text to display if the picture can not load. Yes, see Configure the Set a Control's Properties Action for more information.
Tooltip The value to display when the cursor hovers over the control. Yes, see Configure the Set a Control's Properties Action for more information.
Data Source
Source

The picture to display.

Uploaded images are accessible anonymously by default, so they should not contain sensitive information. To remove anonymous access, change the Forms.Controls.Image.AllowAnonymousAccess setting to False in the web.config files of the SmartForms websites. See the Considerations section for more information.
 Yes, see Configure the Set a Control's Properties Action for more information.
General
Width Adjusts the width of the control. You can enter any whole percentage up to 100%, whole number or pixel value to a maximum of 32767px. Type the dimension. Yes, see Configure the Set a Control's Properties Action for more information.
Height Adjusts the height of the control. You can enter any whole number or pixel value (maximum of 32767px). When set to blank, it's sized to fit the content of the control. Yes, see Configure the Set a Control's Properties Action for more information.
Tab Index Defines a sequence that users follow when they use the Tab key to navigate through a page at runtime. Yes, see Configure the Set a Control's Properties Action for more information.
Visible Shows or hides the control. Yes, see Configure the Set a Control's Properties Action for more information.
Enabled Enables or disables the control. Yes, see Configure the Set a Control's Properties Action for more information.
Format Opens the Format page where you can configure formatting and style features such as format, font, borders, padding and margins. See the Format topic for more information. No
Conditional Format Opens the Conditional Formatting page. You can add conditional formatting to apply a specific format or style when a condition you set is True. Use conditional format on its own or with the Format feature. See Conditional Format for more information. Click the ellipsis to open the Conditional Formatting page. No

The control interacts with other controls through rules. When you bind properties between different controls, you can use the data to populate properties or set values. Use the following examples for when to use the control with other controls through rules:

  • Set a control’s properties: You can configure the settable properties of the control with this action
  • Show/Hide: The Visible property allows you to show or hide the control through rules
  • Enable/Disable: The Enabled property allows you to enable or disable the control through rules
  • Set Focus: You can use the Focus control method in the Rule Designer to set focus to the control in runtime

The following events are available on the control:
Rule Events:

  • When [control] is Active: You can execute a rule condition or action when you hover (mouse over) over the control
  • When [control] is Clicked: You can execute a rule condition or action when the control is clicked. If you configure this event, the cursor also changes to a hand (pointer) when the control is clicked
  • When [control] is Not Active: You can execute a rule condition or action when the cursor moves from within the picture to its container (mouse out)
You can only use the control with the following rule actions:

  • Show a Control
  • Hide a Control
  • Set a Control’s Properties
  • The control is also available when you use forms
  • The Picture control allows anonymous display/download of the picture by default. If anonymous access to the image is a security concern in your environment, you can change an environment setting to prevent the control from showing images with anonymous access. To prevent anonymous image display,log a support ticket on Nintex Customer Central to adjust the Forms.Controls.Image.AllowAnonymousAccess setting to false for your environment.
    This global configuration applies to all SmartForms hosted in the environment. If you use the picture control on anonymous access forms, set the value to true to allow the picture control to function. If this setting is undefined or false, the control will not work on anonymous access forms.
  • If you want the control to change dynamically according to context, for example using a traffic light scenario, you can use multiple picture controls with the if a control contains a specific value rule condition. You can show one of the controls if a condition is true and hide the other controls.