Freigeben über


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.

Abbildung kursiv, fett und fett kursiv aus der Times New Roman-Schriftfamilie 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

Weitere Informationen

IDWriteFontList