WEBfactory 2010

WFTextBox2

WFTextBox2 is an input control that allows the user to input textual values at run time. By default, the control displays the value of the attached signal; to enter a new value and write it to the signal, the user must click on the Edit icon at run time. The control will enter the edit mode, displaying the yellow background, and the user will be able to input the new value and confirm the change by clicking the Confirmation button. Canceling the edit is also possible by clicking the Cancel icon.

Capture643.jpg

WFTextBox2 control

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

  • Signal writing - the WFTextBox2 control can write the inserted textual value to a selected signal.

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

Visual Structure

The Visual Structure section describes the layout of the control at run time, providing detailed naming and descriptions.

Display mode

The WFTextBox2 control starts in display mode, showing the value of the selected signal.

Capture644.jpg

WFTextBox2 default layout

Capture566.jpg - the edit button. When clicked, the WFTextBox2 control will enter the edit mode.

Edit mode

When the Edit button is pressed, the WFTextBox2 control will enter the Edit mode, allowing the user to change the value of the signal.

Capture645.jpg

WFTextBox2 in edit mode

Capture568.jpg - the confirmation button. When clicked, the value is written to the signal.

Capture567.jpg - the canceling button. When clicked, the control will return to Display mode, without writing the new value to the signal.

Run-time Features

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

Writing signals

The WFTextBox2 control allows the user to write a textual value to a signal (Edit mode) and displays the current signal value (Display mode). When the user clicks the Edit button of the control, the control will enter the Edit mode, easily recognized by the yellow background color (the color can be changed at design time). When not in Edit mode, the control will display the current value of the signal.

Capture645.jpg

WFTextBox2 in edit mode

To return to Display mode, the user can either write the new value to the signal by confirming the edit, or cancel the edit and return to Display mode without writing the new value to the signal.

Capture644.jpg

WFTextBox2 display mode

The signal to be written is configurable at design time.

Secure signal writing

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

Capture646.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 WFTextBox2 control. Using the options provided by WEBfactory , the user is able to change the colors and fonts used by the WFTextBox2 control.

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

Signal writing

The WFTextBox2 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 Default tab (Blend).

Advanced Security

The WFTextBox2 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 Misc tab (Blend).

Design-time Properties

The control's design time properties are available in the Properties panel:

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

  2. 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.

  3. 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.

  4. 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.

  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. 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.

  8. 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.

  9. 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.

  10. 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.