訓練
如何列舉字型
本概觀將示範如何依系列名稱列舉系統字型集合中的字型。
此概觀包含下列部分:
使用 DirectWrite Factory 所提供的GetSystemFontCollection方法來傳回IDWriteFontCollection,其中包含所有系統字型。
IDWriteFontCollection* pFontCollection = NULL;
// Get the system font collection.
if (SUCCEEDED(hr))
{
hr = pDWriteFactory->GetSystemFontCollection(&pFontCollection);
}
接下來,使用 IDWriteFontCollection::GetFontFamilyCount從字型集合取得字型系列計數。 我們將使用此專案來迴圈查看集合中的每個字型系列。
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 物件並加以查詢。
使用IDWriteFontCollection::GetFontFamily取得IDWriteFontFamily物件,並將其傳遞至目前的索引i。
IDWriteFontFamily* pFontFamily = NULL;
// Get the font family.
if (SUCCEEDED(hr))
{
hr = pFontCollection->GetFontFamily(i, &pFontFamily);
}
使用 IDWriteFontFamily::GetFamilyNames取得字型系列名稱。 這是 IDWriteLocalizedStrings 物件。 它可以有多個字型系列系列之系列名稱的當地語系化版本。
IDWriteLocalizedStrings* pFamilyNames = NULL;
// Get a list of localized strings for the family name.
if (SUCCEEDED(hr))
{
hr = pFontFamily->GetFamilyNames(&pFamilyNames);
}
使用 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;
最後,使用 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,以開始使用指定的字型系列來格式化文字,依此類故。
若要查看此範例的完整原始程式碼,請參閱 字型列舉範例。
其他資源
文件
-
IDWriteFontFamily::GetFamilyNames (dwrite.h) - Win32 apps
建立當地語系化字串物件,其中包含以地區設定名稱編制索引的字型系列系列名稱。 (IDWriteFontFamily.GetFamilyNames)
-
IDWriteFont::GetInformationalStrings (dwrite.h) - Win32 apps
取得本地化字串集合,其中包含以地區設定名稱編製索引的指定參考字串。
-
[**IDWriteFontSet4**] (/windows/win32/api/dwrite_3/nn-dwrite_3-idwritefontset4) 介面會公開從字型集選取字型的方法。 這些方法可讓您轉換至 *印刷字型系列模型*,同時維持與現有應用程式、檔和字型的相容性。