如何列舉字型

發行項
01/28/2024

本概觀將示範如何依系列名稱列舉系統字型集合中的字型。

此概觀包含下列部分：

步驟 1：取得系統字型集合。
步驟 2：取得字型系列計數。
建立 for Loop。
結論
範例程式碼

步驟 1：取得系統字型集合。

使用 DirectWrite Factory 所提供的GetSystemFontCollection方法來傳回IDWriteFontCollection，其中包含所有系統字型。

IDWriteFontCollection* pFontCollection = NULL;

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

步驟 2：取得字型系列計數。

接下來，使用 IDWriteFontCollection：：GetFontFamilyCount從字型集合取得字型系列計數。我們將使用此專案來迴圈查看集合中的每個字型系列。

UINT32 familyCount = 0;

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

建立 for Loop。

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

現在您已擁有字型集合和字型計數，其餘步驟會迴圈處理每個字型系列，並擷取 IDWriteFontFamily 物件並加以查詢。

步驟 3：取得字型系列。

使用IDWriteFontCollection：：GetFontFamily取得IDWriteFontFamily物件，並將其傳遞至目前的索引i。

IDWriteFontFamily* pFontFamily = NULL;

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

步驟 4：取得系列名稱。

使用 IDWriteFontFamily：：GetFamilyNames取得字型系列名稱。這是 IDWriteLocalizedStrings 物件。它可以有多個字型系列系列之系列名稱的當地語系化版本。

IDWriteLocalizedStrings* pFamilyNames = NULL;

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

步驟 5：尋找地區設定名稱。

使用 IDWriteLocalizedStrings：：FindLocaleName 方法，在您想要的地區設定中取得字型 famliy 名稱。在此情況下，會擷取並要求預設地區設定。如果無法運作，則會要求「en-us」地區設定。如果找不到其中一個指定的地區設定，則本範例只會回復為索引 0，第一個可用的地區設定。

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：取得系列名稱字串長度和字串的長度。

最後，使用 IDWriteLocalizedStrings：：GetStringLength取得系列名稱字串的長度。使用此長度來配置足以保存名稱的字串，然後使用 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);
}

結論

一旦您在地區設定中擁有系列名稱或名稱，您可以列出這些名稱以供使用者選擇，或將其傳遞至 CreateTextFormat，以開始使用指定的字型系列來格式化文字，依此類故。

範例程式碼

若要查看此範例的完整原始程式碼，請參閱字型列舉範例。

共用方式為