Interface IDWriteFontFamily (dwrite.h)

Représente une famille de polices associées.

Héritage

L’interface IDWriteFontFamily hérite d’IDWriteFontList. IDWriteFontFamily a également les types de membres suivants :

Méthodes

L’interface IDWriteFontFamily utilise ces méthodes.

IDWriteFontFamily::GetFamilyNames Crée un objet de chaînes localisées qui contient les noms de famille de la famille de polices, indexés par nom de paramètres régionaux. (IDWriteFontFamily.GetFamilyNames)
IDWriteFontFamily::GetFirstMatchingFont Obtient la police qui correspond le mieux aux propriétés spécifiées.
IDWriteFontFamily::GetMatchingFonts Obtient une liste des polices de la famille de polices classées par ordre de correspondance avec les propriétés spécifiées.

Notes

Une famille de polices est un ensemble de polices qui partagent le même nom de famille, comme « Times New Roman », mais qui diffèrent par leurs caractéristiques. Ces différences de caractéristiques incluent le style, tel que l’italique, et le poids, comme l’gras.

L’illustration suivante montre des exemples de polices qui sont membres de la famille de polices « Times New Roman ».

Un objet IDWriteFontFamily peut être récupéré à partir d’une collection de polices à l’aide de la méthode IDWriteFontCollection::GetFontFamily illustrée dans l’exemple suivant. GetFontFamily prend un index UINT32 et retourne la famille de polices de la police à cet index.

IDWriteFontFamily* pFontFamily = NULL;

// Get the font family.
if (SUCCEEDED(hr))
{
    hr = pFontCollection->GetFontFamily(i, &pFontFamily);
}

Le nom de la famille de polices est utilisé pour spécifier la famille de polices pour les objets de mise en page de texte et de format de texte. Vous pouvez obtenir une liste des noms de famille de polices localisés à partir d’un objet IDWriteFontFamily sous la forme d’un objet IDWriteLocalizedStrings à l’aide de la méthode IDWriteFontFamily::GetFamilyNames , comme indiqué dans le code suivant.

IDWriteLocalizedStrings* pFamilyNames = NULL;

// Get a list of localized strings for the family name.
if (SUCCEEDED(hr))
{
    hr = pFontFamily->GetFamilyNames(&pFamilyNames);
}

Spécifications

Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	dwrite.h

Voir aussi

IDWriteFontList