EnumFontFamiliesExW-Funktion (wingdi.h)

Die EnumFontFamiliesEx-Funktion listet alle eindeutig benannten Schriftarten im System auf, die den von der LOGFONT-Struktur angegebenen Schriftarteigenschaften entsprechen. EnumFontFamiliesEx listet Schriftarten basierend auf dem Namen der Schriftart, dem Zeichensatz oder beidem auf.

Syntax

int EnumFontFamiliesExW(
  [in] HDC           hdc,
  [in] LPLOGFONTW    lpLogfont,
  [in] FONTENUMPROCW lpProc,
  [in] LPARAM        lParam,
       DWORD         dwFlags
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext, aus dem die Schriftarten aufgelistet werden sollen.

[in] lpLogfont

Ein Zeiger auf eine LOGFONT-Struktur , die Informationen zu den zu enumerierenden Schriftarten enthält. Die Funktion untersucht die folgenden Member.

[in] lpProc

Ein Zeiger auf die von der Anwendung definierte Rückruffunktion. Weitere Informationen finden Sie in der Funktion EnumFontFamExProc .

[in] lParam

Ein von der Anwendung definierter Wert. Die Funktion übergibt diesen Wert zusammen mit Schriftartinformationen an die Rückruffunktion.

dwFlags

Dieser Parameter wird nicht verwendet und muss null entsprechen.

Rückgabewert

Der Rückgabewert ist der letzte Wert, der von der Rückruffunktion zurückgegeben wird. Dieser Wert hängt davon ab, welche Schriftfamilien für das angegebene Gerät verfügbar sind.

Hinweise

Die EnumFontFamiliesEx-Funktion verwendet keine getaggten Schriftartnamen, um Zeichensätze zu identifizieren. Stattdessen wird immer der richtige Schriftartname und ein separater Zeichensatzwert an die Rückruffunktion übergeben. Die Funktion listet Schriftarten basierend auf den Werten der Elemente lfCharSet und lfFaceName in der LOGFONT-Struktur auf.

Wie bei EnumFontFamilies zählt EnumFontFamiliesEx alle Schriftstile auf. Nicht alle Formatvorlagen einer Schriftart decken dieselben Zeichensätze ab. Fontorama Bold kann z. B. ANSI-, griechisch- und kyrillische Zeichen enthalten, aber Fontorama Italic kann nur ANSI-Zeichen enthalten. Aus diesem Grund sollten Sie nicht davon ausgehen, dass eine angegebene Schriftart einen bestimmten Zeichensatz abdeckt, auch wenn es sich um den ANSI-Zeichensatz handelt. Die folgende Tabelle zeigt die Ergebnisse verschiedener Kombinationen von Werten für lfCharSet und lfFaceName.

Das folgende Codebeispiel zeigt, wie diese Werte verwendet werden.

// To enumerate all styles and charsets of all fonts: 
lf.lfFaceName[0] = '\0';
lf.lfCharSet = DEFAULT_CHARSET;
HRESULT hr;

// To enumerate all styles and character sets of the Arial font: 
hr = StringCchCopy( (LPSTR)lf.lfFaceName, LF_FACESIZE, "Arial" );
if (FAILED(hr))
{
// TODO: write error handler 
}

lf.lfCharSet = DEFAULT_CHARSET;

// To enumerate all styles of all fonts for the ANSI character set 
lf.lfFaceName[0] = '\0';
lf.lfCharSet = ANSI_CHARSET;

// To enumerate all styles of Arial font that cover the ANSI charset 
hr = StringCchCopy( (LPSTR)lf.lfFaceName, LF_FACESIZE, "Arial" );
if (FAILED(hr))
{
// TODO: write error handler 
}

lf.lfCharSet = ANSI_CHARSET;

Die Rückruffunktionen für EnumFontFamilies und EnumFontFamiliesEx sind sehr ähnlich. Der Standard Unterschied besteht darin, dass die ENUMLOGFONTEX-Struktur ein Skriptfeld enthält.

Hinweis: Basierend auf den Werten von lfCharSet und lfFaceNamelistet EnumFontFamiliesEx dieselbe Schriftart so oft auf, wie es unterschiedliche Zeichensätze in der Schriftart gibt. Dadurch kann eine umfangreiche Liste von Schriftarten erstellt werden, die für einen Benutzer belastend sein kann. Beispielsweise kann die Schriftart Century Schoolbook für die Zeichensätze Baltikum, Westen, Griechisch, Türkisch und Kyrillisch angezeigt werden. Um dies zu vermeiden, sollte eine Anwendung die Liste der Schriftarten filtern.

Die Schriftarten für viele ostasiatische Sprachen weisen zwei Schriftnamen auf: einen englischen Namen und einen lokalisierten Namen. EnumFonts, EnumFontFamilies und EnumFontFamiliesEx geben den namen der englischen Schriftart zurück, wenn das Systemgebietsschema nicht mit der Sprache der Schriftart übereinstimmt.

Wenn der Grafikmodus im Gerätekontext mithilfe der SetGraphicsMode-Funktion auf GM_ADVANCED festgelegt ist und das DEVICE_FONTTYPE-Flag an den FontType-Parameter übergeben wird, gibt diese Funktion eine Liste mit Schriftarten vom Typ 1 und OpenType im System zurück. Wenn der Grafikmodus nicht auf GM_ADVANCED festgelegt ist, gibt diese Funktion eine Liste der Schriftarten vom Typ 1, OpenType und TrueType auf dem System zurück.

Anforderungen

Weitere Informationen

EnumFontFamExProc

EnumFontFamilies

EnumFonts

Schriftart- und Textfunktionen

Übersicht über Schriftarten und Text

LOGFONT