PointCardRW.LineChars Property (POS for .NET v1.12 SDK Documentation)

2/27/2008

Gets or sets the number of characters that can be printed on a line on the point card reader/writer.

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

Syntax

'Declaration
Public MustOverride Property LineChars As Integer

public abstract int LineChars { get; set; }

public:
virtual property int LineChars {
    int get () abstract;
    void set (int value) abstract;
}

/** @property */
public abstract int get_LineChars ()

/** @property */
public abstract void set_LineChars (int value)

public abstract function get LineChars () : int

public abstract function set LineChars (value : int)

Remarks

If changed to a line character width that can be supported, then the width is set to the specified value. If the exact width cannot be supported, then later lines are printed with a character size that most closely supports the specified characters per line. For example, if set to 36 and the point card reader/writer can print either 30 or 40 characters per line, the service object should select the character size "40" and print up to 36 characters on each line.

If the character width cannot be supported, an error is returned. For example, if set to 42 and the point card reader/writer can print either 30 or 40 characters per line, the service object cannot support the request.

Setting LineChars may also update the LineWidth, LineHeight, and LineSpacing properties because the character pitch or font may change.

The value of the LineChars property is typically initialized to the point card reader/writer's default line character width when the device is first enabled by the service object.

Accessing the LineChars property may throw a PosControlException exception with the following ErrorCodes:

Value	Meaning
Illegal	An invalid line character width was specified.

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

PointCardRW Class
PointCardRW Members
Microsoft.PointOfService Namespace
LineCharsList