IDWriteFontFamily-Schnittstelle (dwrite.h)
Stellt eine Familie verwandter Schriftarten dar.
Vererbung
Die IDWriteFontFamily-Schnittstelle erbt von IDWriteFontList. IDWriteFontFamily verfügt auch über folgende Arten von Membern:
Methoden
Die IDWriteFontFamily-Schnittstelle verfügt über diese Methoden.
| IDWriteFontFamily::GetFamilyNames Erstellt ein lokalisiertes Zeichenfolgenobjekt, das die Familiennamen für die Schriftfamilie enthält, die nach Gebietsschemaname indiziert sind. (IDWriteFontFamily.GetFamilyNames) |
| IDWriteFontFamily::GetFirstMatchingFont Ruft die Schriftart ab, die den angegebenen Eigenschaften am besten entspricht. |
| IDWriteFontFamily::GetMatchingFonts Ruft eine Liste der Schriftarten in der Schriftartenfamilie ab, die nach ihrer Übereinstimmung mit den angegebenen Eigenschaften sortiert ist. |
Hinweise
Eine Schriftartfamilie ist eine Reihe von Schriftarten, die denselben Familiennamen wie "Times New Roman" haben, sich aber in den Funktionen unterscheiden. Zu diesen Featureunterschieden gehören der Stil, z. B. kursiv, und die Gewichtung, z. B. fett.
Die folgende Abbildung zeigt Beispiele für Schriftarten, die Mitglieder der Schriftfamilie "Times New Roman" sind.
Ein IDWriteFontFamily-Objekt kann mithilfe der IDWriteFontCollection::GetFontFamily-Methode aus einer Schriftartsammlung abgerufen werden, die im folgenden Beispiel gezeigt wird. GetFontFamily verwendet einen UINT32-Index und gibt die Schriftartfamilie für die Schriftart in diesem Index zurück.
IDWriteFontFamily* pFontFamily = NULL;
// Get the font family.
if (SUCCEEDED(hr))
{
hr = pFontCollection->GetFontFamily(i, &pFontFamily);
}
Der Name der Schriftfamilie wird verwendet, um die Schriftfamilie für Textlayout- und Textformatobjekte anzugeben. Sie können eine Liste lokalisierter Schriftartfamiliennamen aus einem IDWriteFontFamily-Objekt in Form eines IDWriteLocalizedStrings-Objekts abrufen, indem Sie die IDWriteFontFamily::GetFamilyNames-Methode verwenden, wie im folgenden Code gezeigt.
IDWriteLocalizedStrings* pFamilyNames = NULL;
// Get a list of localized strings for the family name.
if (SUCCEEDED(hr))
{
hr = pFontFamily->GetFamilyNames(&pFamilyNames);
}
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dwrite.h |