FontFamily::GetFamilyName-Methode (gdiplusheaders.h)
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