Interface IDWriteFontFamily (dwrite.h)

Representa uma família de fontes relacionadas.

Herança

A interface IDWriteFontFamily herda de IDWriteFontList. IDWriteFontFamily também tem esses tipos de membros:

Métodos

A interface IDWriteFontFamily tem esses métodos.

IDWriteFontFamily::GetFamilyNames Cria um objeto de cadeias de caracteres localizada que contém os nomes de família para a família de fontes, indexados pelo nome da localidade. (IDWriteFontFamily.GetFamilyNames)
IDWriteFontFamily::GetFirstMatchingFont Obtém a fonte que melhor corresponde às propriedades especificadas.
IDWriteFontFamily::GetMatchingFonts Obtém uma lista de fontes na família de fontes classificadas em ordem de quão bem elas correspondem às propriedades especificadas.

Comentários

Uma família de fontes é um conjunto de fontes que compartilham o mesmo nome de família, como "Times New Roman", mas que diferem em recursos. Essas diferenças de recursos incluem estilo, como itálico e peso, como negrito.

A ilustração a seguir mostra exemplos de fontes que são membros da família de fontes "Times New Roman".

Um objeto IDWriteFontFamily pode ser recuperado de uma coleção de fontes usando o método IDWriteFontCollection::GetFontFamily mostrado no exemplo a seguir. GetFontFamily usa um índice UINT32 e retorna a família de fontes para a fonte nesse índice.

IDWriteFontFamily* pFontFamily = NULL;

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

O nome da família de fontes é usado para especificar a família de fontes para objetos de formato de texto e layout de texto. Você pode obter uma lista de nomes de família de fontes localizados de um objeto IDWriteFontFamily na forma de um objeto IDWriteLocalizedStrings usando o método IDWriteFontFamily::GetFamilyNames , conforme mostrado no código a seguir.

IDWriteLocalizedStrings* pFamilyNames = NULL;

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

Requisitos

Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	dwrite.h

Confira também

IDWriteFontList