Action Statement

Refresh the text displayed in regions after the external string DLL has been dynamically changed.

use "xsrefresh" [OBJECT_NAME]

OBJECT_NAME

The identifier for an object.

Description

Refresh the text displayed in regions and controls after the external string DLL has been dynamically changed. All regions, their children, and action bars are refreshed if no name is given. If a name is specified, only the named object and its children are refreshed.

All controls use the current external string values when their parent is made permanent or visible. Thus, any dialog region or dialog box that is temporary and invisible does not need to be refreshed.

Any object or menu item whose text or title bar has been modified by the change text statement will not be changed by a use "xsrefresh" statement. These objects can be updated by repeating the statements that were used to set their text.

The contents of textual regions and table objects are not externalized, so they will not be effected by use "xsrefresh". If they contain text that should be translated, the program will need to reload them. (Column headings in table objects are refreshed.)

In dialog regions or boxes that are permanent or visible, controls that the user can directly modify are not changed by use "xsrefresh", because that might cause loss of a user value or selection. This is true of the following types of controls: entry field, multiline entry field, list box, combination box, drop-down list box, and spin button. A control may be forced to refresh by calling use "xsrefresh" with the name of the control.

Example

 

action ChangeLanguage is

 call EslXstrSetPrimaryDLL (LanguageDLL_SV)

 use "xsrefresh"

 for each member of AlsoRefresh_CLASS loop

         use "xsrefresh" member

 end loop

See Also

EslXstrSetPrimaryDLL( ) ESLLIB Subroutine

EslXstrSetSecondaryDLL ( ) ESLLIB Subroutine