LineDisplayBase.CharacterSetList Property (POS for .NET v1.12 SDK Documentation)

2/27/2008

Holds a string of character set numbers.

Namespace: Microsoft.PointOfService.BaseServiceObjects
Assembly: Microsoft.PointOfService.ControlBase (in microsoft.pointofservice.controlbase.dll)

Syntax

'Declaration
Public Overrides ReadOnly Property CharacterSetList As Integer()

public override int[] CharacterSetList { get; }

public:
virtual property array<int>^ CharacterSetList {
    array<int>^ get () override;
}

/** @property */
public int[] get_CharacterSetList ()

public override function get CharacterSetList () : int[]

Remarks

The string consists of ASCII numeric set numbers separated by commas. For example, if the string is "101,850,999", then the device supports a device-specific character set, code page 850, and the Windows ANSI character set.

LineDisplayBase class verifies that the device has been opened, then retrieves the value of LineDisplayProperties.CharacterSetList. If the value retrieved is null, the CharacterSetList property returns an empty integer array.

CharacterSetList is initialized to an empty integer array by the LineDisplayProperties class. The service object should update CharacterSetList to an appropriate value in its Open method. The LineDisplayProperties class may throw a PosControlException with the following ErrorCode:

Value	Meaning
Illegal	The service object has set CharacterSetList to a null value, a list length of 0, or has set one of the specified values to less than 0 (zero.)

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread-safe. Any instance members are not guaranteed to be thread-safe.

See Also

Reference

LineDisplayBase Class
LineDisplayBase Members
Microsoft.PointOfService.BaseServiceObjects Namespace
LineDisplay.CharacterSetList Property