Configure Emulator Screen Settings Page

This wizard page enables you to specify the settings of the terminal emulator text screen.

This page opens only if you selected a preconfigured setting, or if you selected the Configure Emulator Screen check box in the Configure Emulator Classes page. In this case, your emulator screen is displayed with a red grid overlay.

Important information

You change the settings of the emulator screen to correspond to the required settings for your emulator. The character size, column, and row details for your terminal emulator are generally available from your emulator's connection configuration menu.

As you change the settings for the emulator screen, the grid automatically adjusts to show the new settings.

We recommend specifying the text screen settings in the following order:

  1. Use the Mark Text Area button to mark the text area on your emulator screen.
  2. Fine-tune the text screen settings using the options above the Mark Text Area button.
Wizard map

Terminal Emulator Configuration Wizard Welcome Page > Specify Wizard Operation Page > Emulator Setup Page > Configure HLLAPI Properties Page > HLLAPI Configuration Test Page > Configure Emulator Classes Page > Configure Emulator Screen Settings Page) > Completing the Terminal Emulator Configuration Wizard Page

User interface elements are described below (unlabeled elements are shown in angle brackets):

UI Elements


Mark Text Area

Enables you to define the dimensions of the terminal emulator text area on your emulator screen. When you click this button, the wizard is minimized and the cursor becomes a crosshairs pointer. Drag the pointer on your emulator screen to define the text area.

After you mark the text area on your emulator screen you can fine-tune your settings by adjusting the text screen settings.

<text screen settings>

Screen and Character Sizes

You can specify your emulator's screen size in terms of:

  • Number of columns and rows. Specify the number of columns and rows in your emulator screen.
  • Character size. Select the width and height of your emulator's characters to fit correctly in the defined emulator screen.

Alignment and Offset

You can specify how the text on your emulator's screen should be aligned in relation to the emulator window when the window size changes. The effect of these settings depends on the behavior of your emulator:

  • Screen alignment. Select the vertical alignment (Top or Center) and the horizontal alignment (Left or Center) of the emulator screen inside the window. These options are already optimized for preconfigured emulator settings, and cannot be modified.

    The screen alignment settings determine how UFT One identifies the information on your emulator screen. If you are having trouble recording and running tests or business components (for example, the ClickPosition method is not accurately determining the coordinates), try changing the Screen alignment settings.

  • Screen offset. Select the top and left offset for the text on your emulator screen in relation to the emulator window. For example, if you know that your emulator always reserves one blank row at the top of the screen, set the offset to 1.