SetCX

SetCX - Sets the Cockpit Application Character Set (CX)

Top Previous Next

Syntax

<nCurrentSetting> := SetCX [<nNewSetting>] )

Parameters

<nNewSetting> selection of the Cockpit application character set to be applied.

Allowed values are:

CX_AUTOMATIC. The character set to be assumed is determined by the runtime environment.

CX_ANSI: The character set assumed is ANSI.

CX_OEM: The character set assumed is OEM.

These constants are defined in CharacterSet.ch

If no parameter is passed, the current setting is retained.

Return value

The return value is the current setting.

Description

The Cockpit application character set (CX) controls the text string character set conversions performed during all string transfer functions. This conversion depends on the effective Cockpit application character set which can be retrieved by the function GetECX. The effective application character set is either CX_ANSI or CX_OEM. The effective application character set can be fixed by calling SetCX with CX_ANSI or CX_OEM. If CX_AUTOMATIC is used as parameter to SetCX, the effective character set is determined by the setting in the runtime environment.

If CX_ANSI or CX_OEM are passed to SetCX, this value will be effective for all threads of the application process. If CX_AUTOMATIC is passed, the effective application character set can be thread-relative depending on the runtime environment.

In the Xbase++ runtime environment the effective Cockpit application character set for CX_AUTOMATIC is determined by the SET CHARSET setting.

The default setting for the Cockpit application character set is CX_AUTOMATIC.

Classification

Core