CreateFont

von ActiveVB-Team

Deklaration

Declare Function CreateFont Lib "gdi32" _
                 Alias "CreateFontA" ( _
                 ByVal H As Long, _
                 ByVal W As Long, _
                 ByVal E As Long, _
                 ByVal O As Long, _
                 ByVal W As Long, _
                 ByVal I As Long, _
                 ByVal u As Long, _
                 ByVal S As Long, _
                 ByVal C As Long, _
                 ByVal OP As Long, _
                 ByVal CP As Long, _
                 ByVal Q As Long, _
                 ByVal PAF As Long, _
                 ByVal F As String) As Long

Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel CreateFont des API-Wikis.

CreateFont erzeugt eine logische Schrift mit bestimmten Eigenschaften. Eine Anwendung kann diese Schrift verwenden, indem sie diese für alle Geräte selektiert. Im allgemeinen verwendet man die CreateFont dann, wenn eine Anwendung nur eine Schriftart erzeugen muß. In vielen Fällen ist es einfacher, die Funktion CreateFontIndirect zu verwenden, weil die Schriftdaten in einer LOG_FONT Struktur dargestellt werden.

Parameter
H	Die gewünschte Höhe der Zeichen oder Zeichenzellen der angeforderten Schrift, angegeben in logischen Einheiten. Wenn H größer als Null ist, gibt es die Höhe der Zeichenzellen an. Ist es kleiner als Null, wird die Standardhöhe verwendet.
W	Die durchschnittliche Breite der Zeichen der angeforderten Schrift, angegeben in logischen Einheiten. Ist dieser Wert auf Null gesetzt sucht das System nach der besten Übereinstimmung. Die beste Übereinstimmung wird durch einen Vergleich der Absolutwerte der Differenz zwischen dem aktuellen Aspekt-Verhältnis des aktuellen Gerätes und dem digitalisierten Aspekt-Verhältnis der verfügbaren Schriften erzielt.
E	Der Winkel zwischen Neigungsvektor und der x-Achse des Geräts, angegeben in Zehntel-Grad. Der Neigungsvektor ist parallel zur Grundlinie einer Textzeile.
O	Der Winkel zwischen der Grundlinie eines Zeichens und der x-Achse des Gerätes, angegeben in Zehntelgrad.
W	Die gewünschte Gewichtung der Schrift. Ist dieser Parameter auf Null gesetzt, wird die Standardgewichtung verwendet. Dieser Parameter kann einen der in der untenstehenden Tabelle aufgeführten Werte annehmen.
I	Steht für Kursivschrift auf 1
u	Wird für Unterstrichen auf 1 gesetzt.
S	Wird für Durchgestrichen auf 1 gesetzt.
C	Der gewünschte Zeichensatz. Der OEM-Zeichensatz ist vom Betriebssystem abhängig. Dieser Parameter ist wichtig bei der Schriftabbildung. Um konsistente Ergebnisse sicherzustellen, sollte ein bestimmter Zeichensatz angegeben werden. Wurde im Parameter F eine Schriftart angegeben, sollte sichergestellt werden, daß der hiesige Paramter C einen entsprechenden Zeichensatz spezifiziert. Die folgenden Werde sind vordefiniert: ANSI_CHARSET ARABIC_CHARSET BALTIC_CHARSET CHINESEBIG5_CHARSET DEFAULT_CHARSET EASTEUROPE_CHARSET GB2312_CHARSET GREEK_CHARSET HANGEUL_CHARSET HEBREW_CHARSET JOHAB_CHARSET MAC_CHARSET OEM_CHARSET RUSSIAN_CHARSET SYMBOL_CHARSET THAI_CHARSET TURKISH_CHARSET
OP	Die gewünschte Ausgabegenauigkeit. Sie definiert wie genau die Ausgabe mit der gewünschten Höhe, Breite, Ausrichtung, Neigung und Durchschuß übereinstimmt. Anwendungen können die Werte OUT_DEVICE_PRECIS, OUT_RASTER_PRECIS und OUT_TT_PRECIS zur Steuerung verwenden, welche Schrift verwendet werden, wenn das System mehrere Schriften mit einem bestimmten Namen enthält. OP kann folgende Werte annehmen: OUT_DEFAULT_PRECIS OUT_STRING_PRECIS OUT_CHARACTER_PRECIS OUT_STROKE_PRECIS OUT_TT_PRECIS OUT_DEVICE_PRECIS OUT_RASTER_PRECIS OUT_TT_ONLY_PRECIS OUT_OUTLINE_PRECIS
CP	Die gewünschte Anpassungsgenauigkeit. Dieser Wert definiert, wie Zeichen zugeschnitten werden, die Teilweise außerhalb des Clipping Berreichs liegen. Um eingebettete Read-Only Schriften zu verwenden, Muß eine Anwendung CLIP_EMBEDDED angeben. CP kann einen oder mehrere der folgenden Werte annehmen: CLIP_DEFAULT_PRECIS CLIP_CHARACTER_PRECIS CLIP_STROK_PRECIS CLIP_MASK CLIP_LH_ANGLES CLIP_TT_ALWAYS CLIP_EMBEDDED
Q	Die gewünschte Ausgabequalität. Sie hängt davon ab, wie genau das GDI versucht, den Attributen der logischen Schrift gleichzukommen. Dieser Parameter kann einen der in der untenstehenden Tabelle aufgeführten Werte annehmen.
PAF	Der Durchschuß und die Familie der Schrift. Der Durchschuß wird mit einem der folgenden Werte angegeben: DEFAULT_PITCH FIXED_PITCH VARIABLE_PITCH Dieser Wert kann mit einen der in der untenstehenden Tabelle aufgeführten Werte logisch verodert werden.
F	Ein Zeiger auf einen nullterminierten String mit bis zu 32 Zeichen Länge, der den Namen der Schriftart angibt. Ist dieser Parameter gleich Null, verwendet das GDI eine Standard-Schriftart.

Tabelle 1

Gewichtungswerte
FW_DONTCARE	0
FW_THIN	100
FW_EXTRALIGHT	200
FW_LIGHT	300
FW_NORMAL	400
FW_MEDIUM	500
FW_SEMIBOLD	600
FW_BOLD	700
FW_EXTRABOLD	800
FW_HEAVY	900

Tabelle 2

Qualitätswerte
DEFAULT_QUALITY	Das Erscheinungsbild der Schrift spielt keine Rolle.
DRAFT_QUALITY	Das Erscheinungsbild der Schrift ist weniger wichtig als die PROOF_QUALITY. Für GDI-Rasterschriften wird die Skalierung aktiviert.
PROOF_QUALITY	Die Zeichenqualität der Schrift ist wichtiger als die exakte Übereinstimmung der Attribute der logischen Schrift. Für GDI-Rasterschriften wird die Übereinstimmung deaktiviert und es wir die Schrift gewählt, die der Größe am besten entspricht.

Tabelle 3

Durchschußwerte
FF_DECORATIVE	Dekorative Schrift wie z.B. Old English.
FF_DONTCARE	Egal oder unbekannt.
FF_MODERN	Schriften mit konstanter Strichstärke, mit oder ohne Serifen. Z.B. Pica, Elite oder Courier New
FF_ROMAN	Schriften mit variabler Strichstärke mit oder ohne Serifen. Z.B. MS Serif
FF_SCRIPT	Schriften die wie Handschriften aussehen. Z.B. Script oder Cursive
FF_SWISS	Schriften mit variabler Strichstärke mit und ohne Serifen. Ein Beispiel hierfür wäre MS Sans Serif

Tabelle 4

Rückgabewerte
hFont	War die Funktion erfolgreich wird das Handle der logischen Schrift zurückgegeben.
0	Es lag ein Fehler vor.

Tabelle 5

Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
CreateFontIndirect, SelectObject, TextOut, AddFontResource, EnumFonts, EnumFontFamilies

Zugehörige Tipps

Text in beliebigem Winkel drehen [Tipp 0226]
Einen Text beliebig drehen [Tipp 0506]
Buttonbeschriftung in beliebigem Winkel [Tipp 0507]

Zugehörige Microsoft Knowledge Base Artikel

HOWTO: Display DBCS in a VB Application Running on Windows NT