2.3.5.7 EMR_EXTTEXTOUTA Record

The EMR_EXTTEXTOUTA record draws an ASCII text string using the current font and text colors.

Fields not specified in this section are specified in section 2.3.5.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

Type

Size

Bounds

...

...

...

iGraphicsMode

exScale

eyScale

aEmrText (variable)

...

Type (4 bytes): An unsigned integer that identifies the record type as EMR_EXTTEXTOUTA from the RecordType enumeration (section 2.1.1). This value is 0x00000053.

Bounds (16 bytes): A RectL object ([MS-WMF] section 2.2.2.19), which is not used and MUST be ignored on receipt.

iGraphicsMode (4 bytes): An unsigned integer that specifies the graphics mode from the GraphicsMode enumeration (section 2.1.16).

exScale (4 bytes): A FLOAT value that specifies the scale factor to apply along the X axis to convert from page space units to .01mm units. This SHOULD be used only if the graphics mode specified by iGraphicsMode is GM_COMPATIBLE.

eyScale (4 bytes): A FLOAT value that specifies the scale factor to apply along the Y axis to convert from page space units to .01mm units. This SHOULD be used only if the graphics mode specified by iGraphicsMode is GM_COMPATIBLE.

aEmrText (variable): An EmrText object (section 2.2.5) that specifies the output string in 8-bit ASCII characters, text attributes, and spacing values.

The font and text colors used for output are specified by the state of the current graphics environment (section 3.1.1.2). A rectangle for clipping and/or opaquing can be defined in the EmrText object in the aEmrText field.

This record SHOULD<64> be emulated with an EMR_EXTTEXTOUTW record (section 2.3.5.8), which requires the ASCII text string in the EmrText object to be converted to Unicode UTF16-LE encoding.

See section 2.3.5 for more drawing record types.