BFormat Px Widget examples

Px widget scenarios

When you configure Px widget properties, especially for BoundLabel types with a binding to a component, double-clicking the Text property opens the Text window.

The ObjectToString, Format property determines the content of the displayed text. This property defaults to %.%, which displays the bound component’s ord. In the example, a simple edit adds the words “Heating Mode:” in front of this default BFormat script.

For any point (or any component with an Out property), default text from the binding is identical to the out value displayed in the component’s property sheet. The default text that is identical to the Out value includes facets, as well as the following information:

• If bound to a writable point, the Text Format contains three pieces of data, namely:

  <value> <status> @priorityLevel>

  where:

  • <value> is

  • <status> is {ok}, etc.

  • @jpriorityLevel> is

  For example: On {ok} @16 (a BooleanWritable) or 20% {ok} @12 (a NumericWritable)

• If bound to a read-only point, the Text Format provides two pieces of data, that is:

  <value> <status>

  For example:

  Clean {ok} (a BooleanPoint) or 72.3 °F {ok} (a NumericPoint)

• If bound to a component that is not a point (there is no Out property), you must bind to a particular slot of that component, in order to display text other than its component type.

  For example, if you drag a DegreeDays component to a Px page, the system displays the default text: Degree Days. However, if you change the binding’s ord to <objectName>/clgDegDays, the system calculates and displays the cooling degree-days value (and status), such as: 5.0 {ok}