INF: SETALLJUSTVALUES Print Escape Documented Incorrectly

ID Number: Q65499

3.00

WINDOWS

docerr

Summary:

The Escape subfunction SETALLJUSTVALUES sets all the text

justification values that are used for text output. Since it is no

longer supported in Windows, applications should use the ExtTextOut()

function instead for the outputting of text.

More Information:

The documentation for SETALLJUSTVALUES can be found on pages 11-39 to

11-40 of the "Microsoft Windows Device Development Kit Device Driver

Adaptation Guide," version 3.0, and also on Pages 12-44 to 12-45 of

the "Microsoft Windows Software Development Kit Reference Volume 2,"

version 3.0. Both sections of the documentation are incomplete.

The documentation describes the lpInData parameter as pointing to the

JUST_VALUE_STRUCT data structure. In reality, the lpInData parameter

points to the EXTTEXTDATA data structure, which contains the

JUST_VALUE_STRUCT data structure:

typedef struct

{

short nCharExtra;

WORD nCharCount;

short nBreakExtra;

WORD nBreakCount;

} JUST_VALUE_STRUCT;

typedef struct

{

short nSize;

LPALLJUSTREC lpInData;

LPFONTINFO lpFont;

LPTEXTXFORM lpXForm;

LPDRAWMODE lpDrawMode;

}EXTTEXTDATA;

The nSize field is not used. The JUST_VALUE_STRUCT data structure

documented above should be filled out as instructed in the

documentation; however, the lpInData parameter in the SETALLJUSTVALUES

Escape function points to the EXTTEXTDATA data structure.