|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| -
| Header File
| wingdi.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
LOGFONT
The LOGFONT structure defines the attributes of a font.
typedef struct tagLOGFONT { // lf
LONG lfHeight;
LONG lfWidth;
LONG lfEscapement;
LONG lfOrientation;
LONG lfWeight;
BYTE lfItalic;
BYTE lfUnderline;
BYTE lfStrikeOut;
BYTE lfCharSet;
BYTE lfOutPrecision;
BYTE lfClipPrecision;
BYTE lfQuality;
BYTE lfPitchAndFamily;
TCHAR lfFaceName[LF_FACESIZE];
} LOGFONT;
Members
lfHeight
Specifies the height, in logical units, of the font's character cell or
character. The character height value (also known as the em height) is the character
cell height value minus the internal-leading value. The font mapper interprets
the value specified in lfHeight in the following manner:
Value
| Meaning
| > 0
| The font mapper transforms this value into device units and matches it against
the cell height of the available fonts.
| 0
| The font mapper uses a default height value when it searches for a match.
| < 0
| The font mapper transforms this value into device units and matches its
absolute value against the character height of the available fonts.
|
For all height comparisons, the font mapper looks for the largest font that
does not exceed the requested size.
This mapping occurs when the font is used for the first time.
For the MM_TEXT mapping mode, you can use the following formula to specify a
height for a font with a given point size:
lfHeight = -MulDiv(PointSize, GetDeviceCaps(hDC, LOGPIXELSY), 72);
lfWidth
Specifies the average width, in logical units, of characters in the font. If lfWidth is zero, the aspect ratio of the device is matched against the digitization
aspect ratio of the available fonts to find the closest match, determined by the
absolute value of the difference.
lfEscapement
Specifies the angle, in tenths of degrees, between the escapement vector and
the x-axis of the device. The escapement vector is parallel to the base line of
a row of text.
Windows NT:
When the graphics mode is set to GM_ADVANCED, you can specify the escapement
angle of the string independently of the orientation angle of the string's
characters.
When the graphics mode is set to GM_COMPATIBLE, lfEscapement specifies both the escapement and orientation. You should set lfEscapement and lfOrientation to the same value.
Windows 95:
The lfEscapement member specifies both the escapement and orientation. You should set lfEscapement and lfOrientation to the same value.
lfOrientation
Specifies the angle, in tenths of degrees, between each character's base line
and the x-axis of the device.
lfWeight
Specifies the weight of the font in the range 0 through 1000. For example, 400
is normal and 700 is bold. If this value is zero, a default weight is used.
The following values are defined for convenience:
Value
| Weight
| FW_DONTCARE
| 0
| FW_THIN
| 100
| FW_EXTRALIGHT
| 200
| FW_ULTRALIGHT
| 200
| FW_LIGHT
| 300
| FW_NORMAL
| 400
| FW_REGULAR
| 400
| FW_MEDIUM
| 500
| FW_SEMIBOLD
| 600
| FW_DEMIBOLD
| 600
| FW_BOLD
| 700
| FW_EXTRABOLD
| 800
| FW_ULTRABOLD
| 800
| FW_HEAVY
| 900
| FW_BLACK
| 900
|
lfItalic
Specifies an italic font if set to TRUE.
lfUnderline
Specifies an underlined font if set to TRUE.
lfStrikeOut
Specifies a strikeout font if set to TRUE.
lfCharSet
Specifies the character set. The following values are predefined:
ANSI_CHARSET
DEFAULT_CHARSET
SYMBOL_CHARSET
SHIFTJIS_CHARSET
GB2312_CHARSET
HANGEUL_CHARSET
CHINESEBIG5_CHARSET
OEM_CHARSET
Windows 95 only:
JOHAB_CHARSET
HEBREW_CHARSET
ARABIC_CHARSET
GREEK_CHARSET
TURKISH_CHARSET
THAI_CHARSET
EASTEUROPE_CHARSET
RUSSIAN_CHARSET
MAC_CHARSET
BALTIC_CHARSET
The OEM_CHARSET value specifies a character set that is operating-system
dependent.
You can use the DEFAULT_CHARSET value to allow the name and size of a font to
fully describe the logical font. If the specified font name does not exist, a
font from any character set can be substituted for the specified font, so you
should use DEFAULT_CHARSET sparingly to avoid unexpected results.
Fonts with other character sets may exist in the operating system. If an
application uses a font with an unknown character set, it should not attempt to
translate or interpret strings that are rendered with that font.
This parameter is important in the font mapping process. To ensure consistent
results, specify a specific character set. If you specify a typeface name in
the lfFaceName member, make sure that the lfCharSet value matches the character set of the typeface specified in lfFaceName.
lfOutPrecision
Specifies the output precision. The output precision defines how closely the
output must match the requested font's height, width, character orientation,
escapement, pitch, and font type. It can be one of the following values:
Value
| Meaning
| OUT_CHARACTER_PRECIS
| Not used.
| OUT_DEFAULT_PRECIS
| Specifies the default font mapper behavior.
| OUT_DEVICE_PRECIS
| Instructs the font mapper to choose a Device font when the system contains
multiple fonts with the same name.
| OUT_OUTLINE_PRECIS
| Windows NT: This value instructs the font mapper to choose from TrueType and other
outline-based fonts.
Windows 95: This value is not used.
| OUT_RASTER_PRECIS
| Instructs the font mapper to choose a raster font when the system contains
multiple fonts with the same name.
| OUT_STRING_PRECIS
| This value is not used by the font mapper, but it is returned when raster
fonts are enumerated.
| OUT_STROKE_PRECIS
| Windows NT: This value is not used by the font mapper, but it is returned when TrueType,
other outline-based fonts, and vector fonts are enumerated.
Windows 95: This value is used to map vector fonts, and is returned when TrueType or
vector fonts are enumerated.
| OUT_TT_ONLY_PRECIS
| Instructs the font mapper to choose from only TrueType fonts. If there are no
TrueType fonts installed in the system, the font mapper returns to default
behavior.
| OUT_TT_PRECIS
| Instructs the font mapper to choose a TrueType font when the system contains
multiple fonts with the same name.
|
Applications can use the OUT_DEVICE_PRECIS, OUT_RASTER_PRECIS, and
OUT_TT_PRECIS values to control how the font mapper chooses a font when the operating
system contains more than one font with a given name. For example, if an operating
system contains a font named Symbol in raster and TrueType form, specifying
OUT_TT_PRECIS forces the font mapper to choose the TrueType version. Specifying
OUT_TT_ONLY_PRECIS forces the font mapper to choose a TrueType font, even if it
must substitute a TrueType font of another name.
lfClipPrecision
Specifies the clipping precision. The clipping precision defines how to clip
characters that are partially outside the clipping region. It can be one or more
of the following values:
Value
| Meaning
| CLIP_DEFAULT_PRECIS
| Specifies default clipping behavior.
| CLIP_CHARACTER_PRECIS
| Not used.
| CLIP_STROKE_PRECIS
| Not used by the font mapper, but is returned when raster, vector, or TrueType
fonts are enumerated.
Windows NT: For compatibility, this value is always returned when enumerating fonts.
| CLIP_MASK
| Not used.
| CLIP_EMBEDDED
| You must specify this flag to use an embedded read-only font.
| CLIP_LH_ANGLES
| When this value is used, the rotation for all fonts depends on whether the
orientation of the coordinate system is left-handed or right-handed.
If not used, device fonts always rotate counterclockwise, but the rotation of
other fonts is dependent on the orientation of the coordinate system.
For more information about the orientation of coordinate systems, see the
description of the nOrientation parameter
| CLIP_TT_ALWAYS
| Not used.
|
lfQuality
Specifies the output quality. The output quality defines how carefully the
graphics device interface (GDI) must attempt to match the logical-font attributes
to those of an actual physical font. It can be one of the following values:
Value
| Meaning
| DEFAULT_QUALITY
| Appearance of the font does not matter.
| DRAFT_QUALITY
| Appearance of the font is less important than when PROOF_QUALITY is used. For
GDI raster fonts, scaling is enabled, which means that more font sizes are
available, but the quality may be lower. Bold, italic, underline, and strikeout
fonts are synthesized if necessary.
| PROOF_QUALITY
| Character quality of the font is more important than exact matching of the
logical-font attributes. For GDI raster fonts, scaling is disabled and the font
closest in size is chosen. Although the chosen font size may not be mapped
exactly when PROOF_QUALITY is used, the quality of the font is high and there is no
distortion of appearance. Bold, italic, underline, and strikeout fonts are
synthesized if necessary.
|
lfPitchAndFamily
Specifies the pitch and family of the font. The two low-order bits specify the
pitch of the font and can be one of the following values:
DEFAULT_PITCH
FIXED_PITCH
VARIABLE_PITCH
Bits 4 through 7 of the member specify the font family and can be one of the
following values:
FF_DECORATIVE
FF_DONTCARE
FF_MODERN
FF_ROMAN
FF_SCRIPT
FF_SWISS
The proper value can be obtained by using the Boolean OR operator to join one
pitch constant with one family constant.
Font families describe the look of a font in a general way. They are intended
for specifying fonts when the exact typeface desired is not available. The
values for font families are as follows:
Value
| Meaning
| FF_DECORATIVE
| Novelty fonts. Old English is an example.
| FF_DONTCARE
| Don't care or don't know.
| FF_MODERN
| Fonts with constant stroke width (monospace), with or without serifs.
Monospace fonts are usually modern. Pica, Elite, and CourierNew® are examples.
| FF_ROMAN
| Fonts with variable stroke width (proportional) and with serifs. MS® Serif is an example.
| FF_SCRIPT
| Fonts designed to look like handwriting. Script and Cursive are examples.
| FF_SWISS
| Fonts with variable stroke width (proportional) and without serifs. MS® Sans Serif is an example.
|
lfFaceName
A null-terminated string that specifies the typeface name of the font. The
length of this string must not exceed 32 characters, including the null
terminator. The EnumFontFamilies function can be used to enumerate the typeface names of all currently
available fonts. If lfFaceName is an empty string, GDI uses the first font that matches the other specified
attributes.
See Also
CreateFont, CreateFontIndirect, EnumFontFamilies
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
