Jak wyliczać czcionki

Artykuł
03/22/2025

W tym omówieniu przedstawiono sposób wyliczania czcionek w kolekcji czcionek systemowych według nazwy rodziny.

To omówienie składa się z następujących części:

Krok 1. Pobieranie kolekcji czcionek systemowych.
Krok 2. Uzyskaj liczbę rodzin czcionek.
utworzyć pętlę for.
Wnioski
przykładowy kod

Krok 1. Pobieranie kolekcji czcionek systemowych.

Użyj metody GetSystemFontCollection dostarczonej przez DirectWrite Factory, aby zwrócić IDWriteFontCollection zawierającą wszystkie czcionki systemowe.

IDWriteFontCollection* pFontCollection = NULL;

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

Krok 2: Uzyskaj liczbę rodzin czcionek.

Następnie pobierz liczbę rodzin czcionek z kolekcji czcionek przy użyciu IDWriteFontCollection::GetFontFamilyCount. Użyjemy tej metody do pętli dla każdej rodziny czcionek w kolekcji.

UINT32 familyCount = 0;

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

Utwórz pętlę for.

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

Teraz, gdy masz kolekcję czcionek i liczbę czcionek, reszta kroków polega na iterowaniu przez każdą rodzinę czcionek, pobierając obiekt IDWriteFontFamily i zapytując go.

Krok 3: Uzyskaj rodzinę czcionek.

Pobierz obiekt IDWriteFontFamily używając IDWriteFontCollection::GetFontFamily i przekazując mu bieżący indeks, i.

IDWriteFontFamily* pFontFamily = NULL;

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

Krok 4. Pobieranie nazw rodzin.

Uzyskaj nazwy rodzin czcionek, korzystając z IDWriteFontFamily::GetFamilyNames. Jest to obiekt IDWriteLocalizedStrings. Może mieć wiele zlokalizowanych wersji nazwy rodziny dla rodziny czcionek.

IDWriteLocalizedStrings* pFamilyNames = NULL;

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

Krok 5. Znajdowanie nazwy ustawień regionalnych.

Pobierz nazwę rodziny czcionki w wybranych ustawieniach regionalnych przy użyciu metody IDWriteLocalizedStrings::FindLocaleName. W takim przypadku najpierw są pobierane i żądane domyślne ustawienia regionalne. Jeśli to nie zadziała, zostanie zażądane ustawienie regionalne "en-us". Jeśli jeden z określonych ustawień regionalnych nie zostanie znaleziony, ten przykład po prostu powróci do indeksu 0, pierwsze dostępne ustawienia regionalne.

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;

Krok 6: Uzyskaj długość ciągu nazwy rodziny oraz samego ciągu.

Na koniec pobierz długość ciągu nazwy rodziny przy użyciu IDWriteLocalizedStrings::GetStringLength. Wykorzystaj tę długość do przydzielenia ciągu wystarczająco dużego, aby pomieścić nazwę, a następnie uzyskaj nazwę rodziny czcionek, używając 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);
}

Konkluzja

Po utworzeniu nazwy rodziny lub nazw w ustawieniach regionalnych możesz wyświetlić je dla użytkownika do wyboru lub przekazać go do elementu CreateTextFormat, aby rozpocząć formatowanie tekstu z określoną rodziną czcionek itd.

Przykładowy kod

Aby zobaczyć pełny kod źródłowy dla tego przykładu, zobacz Przykład Wyliczania Czcionek .

Udostępnij za pośrednictwem