AVEVA GraphicRepeaterApp

The AVEVA™ GraphicRepeaterApp shows a graphic that is repeated multiple times based on custom properties assigned to different references. During runtime, the graphic appears in a repeatable list sorted by a single referenced custom property value common to each graphic in the list. Hereafter, the AVEVA™ GraphicRepeaterApp is referred to as the GraphicRepeaterApp.

The GraphicRepeaterApp incorporates the functionality of the SetCustomPropertyValue() method API to change the expression or reference value of a repeatable graphic custom property. No user configuration of the method is required.

The GraphicRepeaterApp is particularly useful for visualizing a common process value across multiple pieces of equipment simultaneously.The following figure shows the GraphicRepeaterApp displaying a common process value for a set of pumps.

Visual and Functional Characteristics of the GraphicRepeaterApp

The GraphicRepeaterApp includes layout properties that modify the appearance of repeatable graphics during runtime and functional properties that filter and sort the list of repeatable graphics. For a complete list of properties that set visual and functional characteristics of the GraphicRepeaterApp, see Configure GraphicRepeaterApp properties.

Visual Characteristics

The GraphicRepeaterApp includes a Layout group of properties that determine the visual appearance of repeatable graphics during runtime.

The GraphicRepeaterApp includes the Sort Order property to arrange repeatable graphics to appear in ascending or descending order based on the value of the custom property specified for the Sort By property.

The size of the GraphicRepeaterApp shown during runtime is based on the size of the layout pane in which it has been placed. Changing the vertical or horizontal dimensions of a pane during runtime changes the size the app.

The following figures show how the GraphicRepeaterApp changes size by increasing the width and height of the pane in which it is placed. In these examples, the fill style of the repeatable graphics are arranged vertically.

The GraphicRepeaterApp includes a Fill Style property, which includes options to arrange repeatable graphics horizontally or vertically. When Fill Style is set to vertical, repeatable graphic size adjusts to the width of the pane. When Fill Style is set to horizontal, repeatable graphic size adjusts to the height of the pane.

Repeatable graphics can be shown in specified numbers of rows and columns by assigning values to the Display Columns and Display Rows properties. The following examples show repeatable graphics arranged in two columns and three rows.

However, the value of the View Mode property determines how the columns and rows appear in the pane.

• View Mode=ListContent

  Graphic items are shown in the GraphicRepeaterApp as a continuous sequential list. The GraphicRepeaterApp includes scroll bars to view graphics that extend beyond the bottom or right border of the pane.

• View Mode =WrapContent

  Repeating graphics are listed in the fill direction until a graphic does not fit within the border of the pane. The graphic then wraps to the next column or row within the pane.

  View Mode=LIst Content	View Mode=WrapContent

Scrollbars are included when repeatable graphics appear outside the pane. If the GraphicRepeaterApp runs on a touch monitor or smart phone, the pane can be scrolled horizontally or vertically with a flick gesture left and right or up and down.

The GraphicRepeaterApp provides two properties to set a background behind the list of repeatable graphics during runtime.

• The Background Graphic property provides the capability to specify a graphic that is placed behind the repeatable graphic and serves as the background

• The Background property includes a color picker to set a background color that appears over the entire surface of the pane in which the GraphicRepeaterApp has been placed.

  Background Graphic Property	Background Property

The background properties are not mutually exclusive. Both properties can be specified simultaneously for an instance of the GraphicRepeaterApp.

Functional Characteristics

The GraphicRepeaterApp includes a Sort group of properties that determine if the list of repeatable graphics are sorted during runtime, their sort order, and if filtering is applied to show only a specified number of graphics with the highest or lowest values.

By default, the list of repeatable graphics is not sorted. Graphics appear by name order. Sorted graphics show repeatable graphics in order by lowest or highest values based on the value of the Sort Order property.

A descending list of repeatable graphics places the highest values at th top. An ascending sort order places the lowest values at the top.

The repeatable list of graphics can be filtered to restrict the display to a specified number of graphics. Based on the sort order, a descending list shows the highest values. An ascending sort order shows the lowest values.