Interface IDWriteFontCollection (dwrite.h)

Um objeto que encapsula um conjunto de fontes, como o conjunto de fontes instaladas no sistema ou o conjunto de fontes em um diretório específico. A API da coleção de fontes pode ser usada para descobrir quais fontes e famílias de fontes estão disponíveis e para obter alguns metadados sobre as fontes.

Herança

A interface IDWriteFontCollection herda da interface IUnknown . IDWriteFontCollection também tem estes tipos de membros:

Métodos

A interface IDWriteFontCollection tem esses métodos.

IDWriteFontCollection::FindFamilyName Localiza a família de fontes com o nome de família especificado.
IDWriteFontCollection::GetFontFamily Cria um objeto de família de fontes com um índice de família de fontes baseado em zero.
IDWriteFontCollection::GetFontFamilyCount Obtém o número de famílias de fontes na coleção.
IDWriteFontCollection::GetFontFromFontFace Obtém o objeto de fonte que corresponde à mesma fonte física que o objeto de face de fonte especificado. A fonte física especificada deve pertencer à coleção de fontes.

Comentários

O método IDWriteFactory::GetSystemFontCollection fornecerá um objeto IDWriteFontCollection , que encapsula o conjunto de fontes instaladas no sistema, conforme mostrado no exemplo de código a seguir.

IDWriteFontCollection* pFontCollection = NULL;

// Get the system font collection.
if (SUCCEEDED(hr))
{
    hr = pDWriteFactory->GetSystemFontCollection(&pFontCollection);
}

IDWriteTextFormat e IDWriteTextLayout têm um método GetFontCollection que retorna a coleção de fontes que está sendo usada pelo objeto . Essas interfaces usam a coleção de fontes do sistema por padrão, mas podem usar uma coleção de fontes personalizada.

Para determinar quais fontes estão disponíveis no sistema, obtenha uma referência à coleção de fontes do sistema. Em seguida, você pode usar o método IDWriteFontCollection::GetFontFamilyCount para determinar o número de fontes e percorrer a lista. O exemplo a seguir enumera as fontes na coleção de fontes do sistema e imprime os nomes da família de fontes no console.

#include <dwrite.h>
#include <string.h>
#include <stdio.h>
#include <new>

// SafeRelease inline function.
template <class T> inline void SafeRelease(T **ppT)
{
    if (*ppT)
    {
        (*ppT)->Release();
        *ppT = NULL;
    }
}

void wmain()
{
    IDWriteFactory* pDWriteFactory = NULL;

    HRESULT hr = DWriteCreateFactory(
            DWRITE_FACTORY_TYPE_SHARED,
            __uuidof(IDWriteFactory),
            reinterpret_cast<IUnknown**>(&pDWriteFactory)
            );

    IDWriteFontCollection* pFontCollection = NULL;

    // Get the system font collection.
    if (SUCCEEDED(hr))
    {
        hr = pDWriteFactory->GetSystemFontCollection(&pFontCollection);
    }

    UINT32 familyCount = 0;

    // Get the number of font families in the collection.
    if (SUCCEEDED(hr))
    {
        familyCount = pFontCollection->GetFontFamilyCount();
    }

    for (UINT32 i = 0; i < familyCount; ++i)
    {
        IDWriteFontFamily* pFontFamily = NULL;

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

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

        UINT32 index = 0;
        BOOL exists = false;
        
        wchar_t localeName[LOCALE_NAME_MAX_LENGTH];

        if (SUCCEEDED(hr))
        {
            // Get the default locale for this user.
            int defaultLocaleSuccess = GetUserDefaultLocaleName(localeName, LOCALE_NAME_MAX_LENGTH);

            // If the default locale is returned, find that locale name, otherwise use "en-us".
            if (defaultLocaleSuccess)
            {
                hr = pFamilyNames->FindLocaleName(localeName, &index, &exists);
            }
            if (SUCCEEDED(hr) && !exists) // if the above find did not find a match, retry with US English
            {
                hr = pFamilyNames->FindLocaleName(L"en-us", &index, &exists);
            }
        }
        
        // If the specified locale doesn't exist, select the first on the list.
        if (!exists)
            index = 0;

        UINT32 length = 0;

        // Get the string length.
        if (SUCCEEDED(hr))
        {
            hr = pFamilyNames->GetStringLength(index, &length);
        }

        // Allocate a string big enough to hold the name.
        wchar_t* name = new (std::nothrow) wchar_t[length+1];
        if (name == NULL)
        {
            hr = E_OUTOFMEMORY;
        }

        // Get the family name.
        if (SUCCEEDED(hr))
        {
            hr = pFamilyNames->GetString(index, name, length+1);
        }
        if (SUCCEEDED(hr))
        {
            // Print out the family name.
            wprintf(L"%s\n", name);
        }

        SafeRelease(&pFontFamily);
        SafeRelease(&pFamilyNames);

        delete [] name;
    }

    SafeRelease(&pFontCollection);
    SafeRelease(&pDWriteFactory);
}

Requisitos

Requisito	Valor
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