FontDirEntry 

The FontDirEntry structure contains information about an individual font in a font resource group.

struct FontDirEntry { 

    WORD dfVersion;

    DWORD dfSize;

    char dfCopyright[60];

    WORD dfType;

    WORD dfPoints;

    WORD dfVertRes;

    WORD dfHorizRes;

    WORD dfAscent;

    WORD dfInternalLeading;

    WORD dfExternalLeading;

    BYTE dfItalic;

    BYTE dfUnderline;

    BYTE dfStrikeOut;

    WORD dfWeight;

    BYTE dfCharSet;

    WORD dfPixWidth;

    WORD dfPixHeight;

    BYTE dfPitchAndFamily;

    WORD dfAvgWidth;

    WORD dfMaxWidth;

    BYTE dfFirstChar;

    BYTE dfLastChar;

    BYTE dfDefaultChar;

    BYTE dfBreakChar;

    WORD dfWidthBytes;

    DWORD dfDevice;

    DWORD dfFace;

    DWORD dfReserved;

    char szDeviceName[];

    char szFaceName[];

};

 

Members

dfVersion

Specifies a user-defined version number for the resource data that tools can use to read and write resource files.

dfSize

Specifies the size of the file, in bytes.

dfCopyright[60]

Contains a 60-character string with the font supplier's copyright information.

dfType

Specifies the type of font file.

dfPoints

Specifies the point size at which this character set looks best.

dfVertRes

Specifies the vertical resolution, in dots per inch, at which this character set was digitized.

dfHorizRes

Specifies the horizontal resolution, in dots per inch, at which this character set was digitized.

dfAscent

Specifies the distance from the top of a character definition cell to the baseline of the typographical font.

dfInternalLeading

Specifies the amount of leading inside the bounds set by the dfPixHeight member. Accent marks and other diacritical characters can occur in this area.

dfExternalLeading

Specifies the amount of extra leading that the application adds between rows.

dfItalic

Specifies an italic font if not equal to zero.

dfUnderline

Specifies an underlined font if not equal to zero.

dfStrikeOut

Specifies a strikeout font if not equal to zero.

dfWeight

Specifies the weight of the font in the range 0 through 1000. For example, 400 is roman and 700 is bold. If this value is zero, a default weight is used. For additional defined values, see the description of the LOGFONT structure.

dfCharSet

Specifies the character set of the font. For predefined values, see the description of the LOGFONT structure.

dfPixWidth

Specifies the width of the grid on which a vector font was digitized. For raster fonts, if the member is not equal to zero, it represents the width for all the characters in the bitmap. If the member is equal to zero, the font has variable-width characters.

dfPixHeight

Specifies the height of the character bitmap for raster fonts or the height of the grid on which a vector font was digitized.

dfPitchAndFamily

Specifies the pitch and the family of the font. For additional information, see the description of the LOGFONT5M4ITK structure.

dfAvgWidth

Specifies the average width of characters in the font (generally defined as the width of the letter x). This value does not include the overhang required for bold or italic characters.

dfMaxWidth

Specifies the width of the widest character in the font.

dfFirstChar

Specifies the first character code defined in the font.

dfLastChar

Specifies the last character code defined in the font.

dfDefaultChar

Specifies the character to substitute for characters not in the font.

dfBreakChar

Specifies the character that will be used to define word breaks for text justification.

dfWidthBytes

Specifies the number of bytes in each row of the bitmap. This value is always even so that the rows start on word boundaries. For vector fonts, this member has no meaning.

dfDevice

Specifies the offset in the file to a null-terminated string that specifies a device name. For a generic font, this value is zero.

dfFace

Specifies the offset in the file to a null-terminated string that names the typeface.

dfReserved

This member is reserved.

szDeviceName

Array that contains a null-terminated string that specifies the name of the device if this font file is designated for a specific device.

szFaceName

Array that contains a null-terminated string that specifies the typeface name of the font.

 

Remarks

There is one FontDirEntry structure for every font in the .RES file. Applications that generate .RES files with font resources must also add to the file a FontDirEntry structure for each font.

Font declarations can be mixed with other resource declarations in the .RC file because fonts do not need to be contiguous in the .RES file.

See Also

DirEntry, FontGroupHdr, LOGFONT