Binding Controls to Host Fields

When a host screen is recorded and all of its fields are converted into GUI controls on your custom form, each of these controls retains a relationship to the host field on the original host screen. This relationship is called a screen binding. Without a screen binding, a control like a text field has no connection with anything beyond itself. A text field with a screen binding to a host field, however, provides a functional connection to the original host application. For example, you could bind user input from a text field to a host field where you want the input entered, or you could bind host output data to populate a label control on your custom application.

To bind a control to a host field
  1. With a recorded screen selected, click the Customize tab.

    Controls on user-defined forms cannot have screen bindings.

  2. Select a control, right-click it, then choose Edit under Screen Binding.

    -or-

    If it is a new control that you created, choose New under Screen Binding.

    Note Screen bindings are not available for buttons, WebLinks, or images.

    The Screen Binding editor appears, showing the original host screen.

  3. Bind your control to a host field.
    To
    Do this
    Send data from this control to a host field
    1. From the From Control page of the Screen Binding editor, select the Send the Control Value to a Host Field check box.

    2. Select the host field you want to send data to by clicking on it, or selecting it from the list box.

      To see all of the host fields highlighted with blue outlines, select the Show Host Fields check box.

    3. Click OK.

      Until you select an unprotected host field, the OK button will be unavailable.

    Send data to this control from a host field
    1. From the To Control page of the Screen Binding editor, select the Send Host Field to Control option button.

    2. Select the host field that has the data you want sent to the control by clicking on it, or selecting it from the list box.

      To see all of the host fields highlighted with blue outlines, select the Show Host Fields check box.

    3. (Optional) If the data you want is not defined by a single host field, you can create a user-defined field by clicking the Create New User Field button, and dragging to define a rectangular area.

      The Create New User Field button looks like this: Create New User Field button

      To see all of the host fields highlighted with blue outlines, select the Show Host Fields check box.

To learn more about screen bindings, try recording a host screen, then switch to the Customize page and look at the screen bindings for the generated controls. To see a screen binding, select a control, then right-click it and choose Edit under Screen Binding. You'll see that for a label control, there is no mapping from the control to the host screen, only from the host screen to the control. Because converted labels are protected fields on the host, you cannot send data from the control to the field. If you try to create a screen binding that sends data to a protected host field, the Screen Binding editor won't let you.

Related Topics
Bullet Customizing Interface Elements, Overview
Bullet Creating Custom Forms
Bullet Assigning Global Variables from Screen Bindings
  Attachmate