FontFamily::GetFamilyName-Methode (gdiplusheaders.h)

  • Artikel

Die FontFamily::GetFamilyName-Methode ruft den Namen dieser Schriftfamilie ab.

Syntax

Status GetFamilyName(
  [out] LPWSTR name,
  [in]  LANGID language
);

Parameter

[out] name

Typ: WCHAR[LF_FACESIZE]

Name dieser Schriftfamilie.

[in] language

Typ: WCHAR

Optional. Sechzehn-Bit-Wert, der die zu verwendende Sprache angibt. Der Standardwert ist LANG_NEUTRAL, die Standardsprache des Benutzers.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Wenn Sie LANG_NEUTRAL als Sprach-ID angeben, ist es üblich, nur LANG_NEUTRAL wie im folgenden Beispiel zu übergeben:

stat = FontFamily.GetFamilyName(name, LANG_NEUTRAL);

Wenn Sie eine andere Sprache als LANG_NEUTRAL angeben, verwenden Sie MAKELANGID, um die Sprach- und Untersprachekombination wie im folgenden Beispiel zu erstellen:

LANGID language = MAKELANGID(LANG_CHINESE, SUBLANG_CHINESE_TRADITIONAL);

Eine Liste der verfügbaren Sprachen und Untersprachen finden Sie unter Winnt.h.

Beispiele

Im folgenden Beispiel wird ein FontFamily-Objekt erstellt, der Familienname abgerufen und der Name als Text ausgegeben.

VOID Example_GetFamilyName(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a FontFamily object.
   FontFamily nameFontFamily(L"arial");
   
   // Get the cell ascent of the font family in design units.
   WCHAR      familyName[LF_FACESIZE];
   nameFontFamily.GetFamilyName(familyName);

   // Copy the cell ascent into a string and draw the string.
   SolidBrush solidbrush(Color(255, 0, 0, 0));
   Font       font(&nameFontFamily, 16);
   graphics.DrawString(familyName, -1, &font, PointF(0, 0), &solidbrush);
}

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile gdiplusheaders.h (include Gdiplus.h)
Bibliothek Gdiplus.lib
DLL Gdiplus.dll

Weitere Informationen

Erstellen von Schriftartfamilien und Schriftarten

Auflisten der installierten Schriftarten

FontFamily