LOGFONTW-Struktur (shtypes.h)

Definiert die Attribute einer Schriftart.

Syntax

typedef struct tagLOGFONTW {
  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;
  WCHAR lfFaceName[32];
} LOGFONTW;

Elemente

lfHeight

Typ: LONG

Gibt die Höhe der Zeichenzelle oder des Zeichens der Schriftart in logischen Einheiten an. Der Zeichenhöhenwert (auch als Em-Höhe bezeichnet) ist der Wert der Zeichenzellenhöhe minus dem internen vorangestellten Wert. Der Schriftart-Mapper interpretiert den in lfHeight angegebenen Wert wie folgt.

Bei allen Höhenvergleichen sucht der Schriftzuordnungs-Mapper nach der größten Schriftart, die die angeforderte Größe nicht überschreitet.

Diese Zuordnung tritt auf, wenn die Schriftart zum ersten Mal verwendet wird.

Für den MM_TEXT Zuordnungsmodus können Sie die folgende Formel verwenden, um eine Höhe für eine Schriftart mit einer bestimmten Punktgröße anzugeben.

lfHeight = -MulDiv(PointSize, GetDeviceCaps(hDC, LOGPIXELSY), 72);

Wobei MulDiv wie folgt definiert ist:

#define MulDiv(a,b,c)    (((a)*(b))/(c))

lfWidth

Typ: LONG

Gibt die durchschnittliche Breite in logischen Einheiten von Zeichen in der Schriftart an. Wenn lfWidth nicht null ist, wird das Seitenverhältnis des Geräts mit dem Digitalisierungs-Seitenverhältnis der verfügbaren Schriftarten abgeglichen, um die nächstgelegene Übereinstimmung zu finden, die durch den absoluten Wert der Differenz bestimmt wird.

lfEscapement

Typ: LONG

Gibt den Winkel zwischen dem Escapevektor und der X-Achse des Geräts in Zehntel grad an. Der Escapezeichenvektor ist parallel zur Basiszeile einer Textzeile.

Das Element "lfEscapement " gibt sowohl das Escapezeichen als auch die Ausrichtung an. Sie sollten "lfEscapement " und "lfOrientation " auf denselben Wert festlegen.

lfOrientation

Typ: LONG

Gibt den Winkel zwischen der Basislinie jedes Zeichens und der X-Achse des Geräts in Zehntel grad an.

lfWeight

Typ: LONG

Gibt die Stärke der Schriftart im Bereich 0 bis 1000 an. Beispielsweise ist 400 normal und 700 fett formatiert. Wenn dieser Wert null ist, wird eine Standardgewichtung verwendet.

Die folgenden Werte werden in Wingdi.h zur Vereinfachung definiert.

lfItalic

Typ: BYTE

TRUE , um eine kursiv formatierte Schriftart anzugeben.

lfUnderline

Typ: BYTE

TRUE , um eine unterstrichene Schriftart anzugeben.

lfStrikeOut

Typ: BYTE

TRUE , um eine durchgestrichene Schriftart anzugeben.

lfCharSet

Typ: BYTE

Gibt den Zeichensatz an. Die folgenden Werte sind vordefinierte:

Schriftarten mit anderen Zeichensätzen können im Betriebssystem vorhanden sein. Wenn eine Anwendung eine Schriftart mit einem unbekannten Zeichensatz verwendet, sollte nicht versucht werden, Zeichenfolgen zu übersetzen oder zu interpretieren, die mit dieser Schriftart gerendert werden.

Dieses Element ist im Schriftartenzuordnungsprozess wichtig. Um konsistente Ergebnisse sicherzustellen, geben Sie einen bestimmten Zeichensatz an. Wenn Sie einen Schriftartnamen im Element "lfFaceName " angeben, stellen Sie sicher, dass der lfCharSet-Wert dem Zeichensatz der in lfFaceName angegebenen Schriftart entspricht.

lfOutPrecision

Typ: BYTE

Gibt die Ausgabegenauigkeit an. Die Ausgabegenauigkeit definiert, wie genau die Ausgabe mit der Höhe, Breite, Zeichenausrichtung, Escapezeichen, Pitch und Schriftarttyp der angeforderten Schriftart übereinstimmen muss. Es kann sich um einen der folgenden Werte handeln, die in Wingdi.h definiert sind:

lfClipPrecision

Typ: BYTE

Gibt die Beschneidungsgenauigkeit an. Die Beschneidungsgenauigkeit definiert, wie Zeichen abgeschnitten werden, die sich teilweise außerhalb des Beschneidungsbereichs befinden. Es kann sich um einen oder mehrere der folgenden Werte handeln, die in Wingdi.h definiert sind:

lfQuality

Typ: BYTE

Gibt die Ausgabequalität an. Die Ausgabequalität definiert, wie sorgfältig der GDI versuchen muss, die Attribute der logischen Schriftart mit denen einer tatsächlichen physischen Schriftart abzugleichen. Es kann sich um einen der folgenden Werte handeln, die in Wingdi.h definiert sind:

lfPitchAndFamily

Typ: BYTE

Gibt den Schriftgrad und die Gruppe der Schriftart an. Die beiden Bits in niedriger Reihenfolge geben den Schriftgrad an und können eine der folgenden Werte sein, die in Wingdi.h definiert sind:

• DEFAULT_PITCH
• FIXED_PITCH
• MONO_FONT
• VARIABLE_PITCH

• FF_DECORATIVE
• FF_DONTCARE
• FF_MODERN
• FF_ROMAN
• FF_SCRIPT
• FF_SWISS

Schriftfamilien beschreiben das Aussehen einer Schriftart auf allgemeine Weise. Sie sind für die Angabe von Schriftarten vorgesehen, wenn die gewünschte Schriftart nicht verfügbar ist. Die Werte für Schriftfamilien sind wie folgt:

lfFaceName[32]

Typ: TCHAR[LF_FACESIZE]

Gibt eine mit Null beendete Zeichenfolge an, die den Schriftartnamen angibt. Die Länge dieser Zeichenfolge darf 32 Zeichen, einschließlich des endenden NULL-Zeichens, nicht überschreiten. Die EnumFontFamilies-Funktion kann verwendet werden, um die Schriftartnamen aller derzeit verfügbaren Schriftarten aufzulisten. Wenn lfFaceName eine leere Zeichenfolge ist, verwendet GDI die erste Schriftart, die den anderen angegebenen Attributen entspricht.

Bemerkungen

In den folgenden Situationen wird clearType-Antialiasing nicht unterstützt:

• Text wird auf einem Drucker gerendert.
• Anzeigesatz für 256 Farben oder weniger.
• Text wird auf einem Terminalserverclient gerendert.
• Die Schriftart ist keine TrueType-Schriftart oder eine Microsoft OpenType-Schriftart mit TrueType-Gliederungen. Beispielsweise wird die ClearType-Antialiasing nicht unterstützt: Typ 1 Schriftarten, Postscript OpenType-Schriftarten ohne TrueType-Gliederungen, Bitmapschriftarten, Vektorschriftarten und Geräteschriftarten.
• Die Schriftart verfügt über eingebettete Bitmaps für alle Schriftgrade, die die eingebetteten Bitmaps enthalten. Dies tritt beispielsweise häufig in ostasiatischen Schriftarten auf.

Anforderungen

Siehe auch

IVisualProperties::GetFont

IVisualProperties::SetFont