WEBfactory 2010

WFNumericBox1

WFNumericBox1 is an input control that allows the user to input numbers at run time. The control also displays the current value in the numeric input field. The units and precision can be set up at design time.

Capture542.jpg

WFNumericBox1 control

Features
  • Visual customization - users can customize the look of the control at design time.

  • Signal writing - the WFNumericBox1 control can write the inserted numeric value to a selected signal.

  • Advanced security - the WFNumericBox1 control offers the complete security options, keeping away the unnecessary complications.

  • Multi-language support - the units and precision separator is automatically adjusted to match the desired culture.

Run-time Features

The run-time features section describes the controls features at run time.

Writing signals

The WFNumericBox1 control allows the user to write a numeric value to a signal and displays the current signal value. When the user inserts a value in the control, the control will enter the edit mode, easily recognized by the yellow background color. When not in edit mode, the control will display the current value of the signal.

Capture543.jpg

WFNumericBox1 control

The signal to be written is configurable at design time.

Secure signal writing

The WFNumericBox1 control can be configured to add an extra security layer when writing a signal (input a numeric value at run time).

Capture544.jpg

WriteSecure at run time

The security options are configurable from design time.

Design-time Features

The design-time features section describes the controls features at design time.

Visual customization

The user has the possibility to control the looks of the WFNumericBox1 control. Using the options provided by WEBfactory , the user is able to change the colors and fonts used by the WFNumericBox1 control.

This feature can be found under the Appearance category (SmartEditor) or Brushes category (Blend).

Signal writing

The WFNumericBox1 control allows the user to configure a signal in order to write the value to the signal at run time.

This feature can be found under the Signals category (SmartEditor) or WEBfactory 2010 - Signals category (Blend).

Units

The WFNumericBox1 control provides the option to set up the units for the numeric value inserted at run time. The unit symbolic text must be previously defined in WEBfactoryStudio.

This feature can be found under the Configuration category (SmartEditor) or WEBfactory 2010 - General category (Blend).

Precision

The WFNumericBox1 control provides the option to set up the number of decimals the value will be written with.

This feature can be found under the Configuration category (SmartEditor) or WEBfactory 2010 - General category (Blend).

Advanced Security

The WFNumericBox1 allows the user to customize the security options in various ways: the control's enabled or disabled status and the visibility status can be conditioned by a signal's value. Also the authorizations based security options are available.

This feature can be found under the Security category (SmartEditor) or or WEBfactory 2010 - Security category (Blend).

Design-time Properties

The WFNumericBox1 properties are available in the Properties panel:

  1. Precision - the number of decimals of the numeric value.

  2. Unit - the unit in which the value is expressed. The unit symbolic text must be previously defined in WEBfactoryStudio.

  3. EnableMask - the binary mask used for enabling or disabling the control. The control uses the bitwise AND operation between the binary value of the signal set at the EnableSignalName property and the binary value of the mask. This bitwise AND operation must equate to the binary value of the mask in order to be true (e.g. Signal & Mask = Mask). The control is disabled when the bitwise operation is true and enabled when the bitwise operation is false.

  4. EnableSignalName - the signal that will control the enabled or disabled state of the control. The binary value of the selected signal is used together with the EnableMask binary value to toggle between the control's enabled or disabled states.

  5. SecurityAuthorizationName - allows the user to select an authorization group. The members of the selected authorization group will have access to the control.

  6. SecurityDenyAccessBehaviour - allows the user to select a behavior that will be active when a user that doesn't belong to the above selected authorization group logs in. The action can either be disabled or hidden.

  7. VisibilityMask - the binary mask used for displaying or hiding the control. The control uses the bitwise AND operation between the binary value of the signal set at the VisibilitySignalName property and the binary value of the mask. This bitwise AND operation must equate to the binary value of the mask in order to be true (e.g. Signal & Mask = Mask). The control is hidden when the bitwise operation is true and visible when the bitwise operation is false.

  8. VisibilitySignalName - the signal that will control the visibility of the control. The binary value of the selected signal is used together with the VisibilityMask binary value to toggle between the control's visible or hidden states.

  9. WriteSecure - allows the user to enable an extra security layer. If active, the user will be asked to confirm the login password in order to modify any signal.

  10. ObjectID - allows the user to define an object name for the control, that can be passed as SignalPrefix when using parameter passing in navigation.

  11. SignalName - allows the user to select a signal (using the SignalBrowser of by typing the signal name in the text box). The selected signal's value will be displayed/written by the control at run time.

  12. SignalPrefix - allows the user to select a signal prefix that can be passed when using parameter control and parameter passing in navigation. The signal prefix can be the ObjectName, ObjectName_PageSignalPrefix, PageSignalPrefix or PageSignalPrefix_ObjectName.