Come enumerare i tipi di carattere

  • Articolo

Questa panoramica illustra come enumerare i tipi di carattere nella raccolta di tipi di carattere di sistema in base al nome della famiglia.

Questa panoramica è costituita dalle parti seguenti:

Passaggio 1: Ottenere la raccolta di tipi di carattere di sistema.

Utilizzare il metodo GetSystemFontCollection fornito dalla DirectWrite Factory per restituire un OGGETTO IDWriteFontCollection con tutti i tipi di carattere di sistema.

IDWriteFontCollection* pFontCollection = NULL;

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

Passaggio 2: Ottenere il conteggio della famiglia di caratteri.

Ottenere quindi il numero di famiglie di caratteri dalla raccolta di tipi di carattere usando IDWriteFontCollection::GetFontFamilyCount. Verrà usato per eseguire un ciclo su ogni famiglia di caratteri nella raccolta.

UINT32 familyCount = 0;

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

Crea un oggetto For Loop.

for (UINT32 i = 0; i < familyCount; ++i)

Ora che si dispone della raccolta di tipi di carattere e del numero di tipi di carattere, i passaggi rimanenti vengono scorrere ogni famiglia di caratteri, recuperando l'oggetto IDWriteFontFamily ed eseguirne una query.

Passaggio 3: Ottenere la famiglia di caratteri.

Ottenere un oggetto IDWriteFontFamily usando IDWriteFontCollection::GetFontFamily e passandolo all'indice corrente, i.

IDWriteFontFamily* pFontFamily = NULL;

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

Passaggio 4: Ottenere i nomi di famiglia.

Ottenere i nomi della famiglia di caratteri usando IDWriteFontFamily::GetFamilyNames. Si tratta di un oggetto IDWriteLocalizedStrings . Può avere più versioni localizzate del nome della famiglia di caratteri.

IDWriteLocalizedStrings* pFamilyNames = NULL;

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

Passaggio 5: Trovare il nome delle impostazioni locali.

Ottenere il nome del tipo di carattere famliy nelle impostazioni locali desiderate usando il metodo IDWriteLocalizedStrings::FindLocaleName . In questo caso, le impostazioni locali predefinite vengono recuperate e richieste. Se non funziona, vengono richieste le impostazioni locali "en-us". Se una delle impostazioni locali specificate non viene trovata, in questo esempio viene semplicemente eseguito il fallback all'indice 0, le prime impostazioni locali disponibili.

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;

Passaggio 6: Ottenere la lunghezza della lunghezza della stringa del nome di famiglia e della stringa.

Ottenere infine la lunghezza della stringa del nome della famiglia usando IDWriteLocalizedStrings::GetStringLength. Usare questa lunghezza per allocare una stringa sufficientemente grande da contenere il nome e quindi ottenere il nome della famiglia di caratteri usando IDWriteLocalizedStrings::GetString.

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);
}

Conclusione

Dopo aver ottenuto il nome o i nomi della famiglia nelle impostazioni locali, è possibile elencarli per consentire all'utente di scegliere o passarlo a CreateTextFormat per iniziare a formattare il testo con la famiglia di caratteri specificata e così via.

Codice di esempio

Per visualizzare il codice sorgente completo per questo esempio, vedere l'esempio di enumerazione dei caratteri.