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 |