Share via

PosPrinter.MapMode Property

  • Article

2/27/2008

Gets or sets the mapping mode of the printer the application wants to use.

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

Syntax

'Declaration
Public MustOverride Property MapMode As MapMode

public abstract MapMode MapMode { get; set; }

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

/** @property */
public abstract MapMode get_MapMode ()

/** @property */
public abstract void set_MapMode (MapMode value)

public abstract function get MapMode () : MapMode

public abstract function set MapMode (value : MapMode)

Remarks

Possible values are defined by the MapMode enumeration.

The mapping mode defines the unit of measure used for other properties, such as line height and line spacing.

Setting MapMode may also change the JrnLineHeight, JrnLineSpacing, JrnLineWidth, RecLineHeight, RecLineSpacing, RecLineWidth, SlpLineHeight, SlpLineSpacing, and SlpLineWidth properties.

The value of MapMode is set when the device is first enabled following the Open method.

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

Value

Meaning

Illegal

The specified mapping mode is not valid—that is, it does not exist in the MapMode enumeration.

Note

From the POS printer perspective, the exact definition of a "dot" is not significant. It is a printer/service object unit used to express various metrics. For example, some printers define a "halfdot" that is used in high-density graphics printing, and perhaps in text printing. A printer’s service object may handle this case in one of these ways:

  • Consistently define a "dot" as the printer’s smallest physical size, that is, a half-dot.

  • If the service object changes bitmap graphics printing density based on the XxxLetterQuality setting, then alter the size of a dot to match the bitmap density (that is, a physical printer dot when false and a half-dot when true). Notice that this choice should not be used if the printer’s text metrics are based on half-dot sizes, because accurate values for the metrics may not then be possible.

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