5.2.1 Group-File Header

The group-file header contains general information about the group file. The GROUPHEADER structure has the following form:

struct tagGROUPHEADER {
    char  cIdentifier[4];
    WORD  wCheckSum;
    WORD  cbGroup;
    WORD  nCmdShow;
    RECT  rcNormal;
    POINT ptMin;
    WORD  pName;
    WORD  wLogPixelsX;
    WORD  wLogPixelsY;
    WORD  wBitsPerPixel;
    WORD  wPlanes;
    WORD  cItems;
    WORD  rgiItems[cItems];
};

Following are the members in the GROUPHEADER structure:

cIdentifier

Identifies an array of 4 characters. If the file is a valid group file, this array must contain the string “PMCC”.

wCheckSum

Specifies the negative sum of all words in the file (including the value specified by the wCheckSum member).

cbGroup

Specifies the size of the group file, in bytes.

nCmdShow

Specifies whether Program Manager should display the group in minimized, normal, or maximized form. This member can be one of the following values:

rcNormal

Specifies the coordinates of the group window (the window in which the group icons appear). It is a rectangular structure.

ptMin

Specifies the coordinate of the lower-left corner of the group window with respect to the parent window. It is a point structure.

pName

Specifies an offset from the beginning of the file to a null-terminated string that specifies the group name.

wLogPixelsX

Specifies the horizontal display resolution for which the group icons were created.

wLogPixelsY

Specifies the vertical display resolution for which the group icons were created.

wBitsPerPixel

Specifies the format of the icon bitmaps, in bits per pixel.

wPlanes

Specifies the count of planes in the icon bitmaps.

cItems

Specifies the number of ITEMDATA structures in the rgiItems array. (There may also be NULL entries in the rgiItems array.)

rgiItems[cItems]

Specifies an array of ITEMDATA structures.