Share via

PosPrinter.RecLineChars Property

  • Article

2/27/2008

Gets or sets the number of characters that the application wants to print on a receipt line.

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

Syntax

'Declaration
Public MustOverride Property RecLineChars As Integer

public abstract int RecLineChars { get; set; }

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

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

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

public abstract function get RecLineChars () : int

public abstract function set RecLineChars (value : int)

Remarks

If the specified number of characters per line can be supported, the service object sets the line width to the specified value. If the exact width cannot be supported and the value is less than the maximum value allowed for the printer, later lines will be printed with the number that most closely supports the specified characters per line. (For example, if RecLineChars is set to 36 and the printer can print either 30 or 40 characters per line, the service object should select the line width of 40 and print up to 36 characters on each line.)

If the specified line width cannot be supported and the value is greater than the maximum value allowed for the printer, then an error is returned. (For example, if RecLineChars is set to 42 and the printer can print either 30 or 40 characters per line, the service object cannot support the request.)

Setting RecLineChars may also update the RecLineWidth, RecLineHeight, and RecLineSpacing properties, because the character pitch or font may be changed.

The service object sets RecLineChars to the printer’s default line width when the device is first enabled following the Open method.

Accessing RecLineChars may cause a PosControlException to be thrown with the following ErrorCode:

Value

Meaning

Illegal

The specified number of characters is greater than the maximum allowed for the printer.

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

PosPrinter Class
PosPrinter Members
Microsoft.PointOfService Namespace
RecLineWidth
RecLineHeight
RecLineSpacing
RecLineCharsList