Skip to content

Progress Bar

The ProgressBar widget displays a visual progress indicator, showing the progress of an operation or task.

XML Fields

  • XPath establishes the current data context for the widget.
  • ValueXPath provides the numeric progress value. It may be a relative path or an expression evaluated from the current context.
  • MaximumXPath provides the numeric maximum. Leave it empty to use 100.
  • Format controls the displayed text: Percentage appends % to the configured value, while Fraction displays the configured value without that suffix. MaximumXPath controls the bar's maximum independently; the widget does not calculate a percentage from it.
  • Hints provides help text and Rules contains conditional form behavior.

ProgressBar is display-only. It reads its value and maximum from the form data; users cannot change them through the bar.

Progress Value and Display

The progress is represented as a value bound to a data model element. The display format can be either a fraction or a percentage.

Maximum Value

The maximum value for the progress bar is determined by the MaximumXPath property. If this property is not set, the default maximum value is 100. If a different maximum value is needed, an XPath expression evaluating to the desired maximum value should be provided.

Example

1
2
3
4
5
6
<ProgressBar Format="Percentage" XPath="num">
    <Hints><![CDATA[]]></Hints>
    <Rules/>
    <MaximumXPath><![CDATA[]]></MaximumXPath>
    <ValueXPath><![CDATA[75]]></ValueXPath>
</ProgressBar>