Betűtípusok számbavétele

Ez az áttekintés bemutatja, hogyan sorolhatja fel a betűtípusokat a rendszer betűtípusgyűjteményében családnév alapján.

Ez az áttekintés a következő részekből áll:

• 1. lépés: A rendszer betűkészletének lekérése.
• 2. lépés: A betűcsaládok számának lekérése.
• For Loop létrehozása.
  • 3. lépés: A betűtípuscsalád lekérése.
  • 4. lépés: A családnevek lekérése.
  • 5. lépés: A területi név megkeresése.
  • 6. lépés: A családnév sztringjének hosszának és a sztringnek a lekérése.
• Következtetés
• példakód

1. lépés: A rendszer betűkészletének lekérése.

A DirectWrite Factory által biztosított GetSystemFontCollection metódus segítségével visszaadhat egy olyan IDWriteFontCollection-t, amely tartalmazza a rendszer összes betűtípusát.

IDWriteFontCollection* pFontCollection = NULL;

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

2. lépés: A betűcsaládok számának lekérése.

Ezután kérje le a betűcsaládok számát a betűtípusgyűjteményből IDWriteFontCollection::GetFontFamilyCounthasználatával. Ezzel a használatával a gyűjtemény minden betűcsaládját átfuttatjuk.

UINT32 familyCount = 0;

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

Készítsen egy 'for' ciklust.

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

Most, hogy már rendelkezik a betűkészlettel és a betűszámmal, a többi lépés végighalad az egyes betűcsaládok között, beolvassa az IDWriteFontFamily objektumot, és lekérdezi azt.

3. lépés: A betűtípuscsalád lekérése.

Szerezze meg a(z) IDWriteFontFamily objektumot azáltal, hogy a(z) IDWriteFontCollection::GetFontFamily függvényt használja, és átadja neki az aktuális indexet, i.

IDWriteFontFamily* pFontFamily = NULL;

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

4. lépés: A családnevek lekérése.

A betűtípuscsaládok nevét az IDWriteFontFamily::GetFamilyNameshasználatával szerezheti be. Ez egy IDWriteLocalizedStrings objektum. A betűtípuscsalád családnevének több honosított verziója is lehet.

IDWriteLocalizedStrings* pFamilyNames = NULL;

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

5. lépés: Keresse meg a területi nevet.

Szerezze meg a betűtípus család nevét a kívánt nyelvi beállítással az IDWriteLocalizedStrings::FindLocaleName metódus használatával. Ebben az esetben először az alapértelmezett területi beállítás lesz lekérve és kérve. Ha ez nem működik, a rendszer kéri a "en-us" területi beállításokat. Ha valamelyik megadott területi beállítás nem található, ez a példa egyszerűen visszaesik a 0 indexre, az első elérhető területi beállításra.

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;

6. lépés: A családnév sztring hosszának és a sztringnek a lekérése.

Végül az IDWriteLocalizedStrings::GetStringLengthhasználatával szerezze meg a családnév karakterlánc hosszát. Ezzel a hosszúsággal foglalhat le egy olyan karakterláncot, amely elég nagy a név számára, majd a betűcsalád nevét a IDWriteLocalizedStrings::GetStringhasználatával kérheti le.

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

Következtetés

Miután megadta a családnevet vagy a neveket a területi beállításban, listázhatja őket a felhasználó számára, vagy átadhatja a CreateTextFormatnak, hogy megkezdje a szöveg formázását a megadott betűtípuscsaláddal, és így tovább.

Példakód

A példához tartozó teljes forráskódot a Font Enumeration Samplecímű cikkben tekinthet meg.