idWriteLocalizedStrings 接口 (dwrite.h)

表示按区域设置名称编制索引的字符串的集合。

继承

IDWriteLocalizedStrings 接口继承自 IUnknown 接口。 IDWriteLocalizedStrings 还具有以下类型的成员：

方法

IDWriteLocalizedStrings 接口包含以下方法。

IDWriteLocalizedStrings：：FindLocaleName 获取具有指定区域设置名称的区域设置名称/字符串对的从零开始的索引。
IDWriteLocalizedStrings：：GetCount 获取语言/字符串对的数目。
IDWriteLocalizedStrings：：GetLocaleName 将具有指定索引的区域设置名称复制到指定的数组。 (IDWriteLocalizedStrings.GetLocaleName)
IDWriteLocalizedStrings：：GetLocaleNameLength 获取长度（以字符为单位） (不包括具有指定索引的区域设置名称的 null 终止符) 。 (IDWriteLocalizedStrings.GetLocaleNameLength)
IDWriteLocalizedStrings：：GetString 将具有指定索引的字符串复制到指定的数组。 (IDWriteLocalizedStrings.GetString)
IDWriteLocalizedStrings：：GetStringLength 获取长度（以字符为单位） (不包括具有指定索引的字符串的 null 终止符) 。 (IDWriteLocalizedStrings.GetStringLength)

注解

IDWriteLocalizedStrings 表示的字符串集按映射到区域设置的从零开始的 UINT32 数字编制索引。 使用 FindLocaleName 方法检索特定区域设置的数字索引。

IDWriteLocalizedStrings 接口的常见用途是保存使用 IDWriteFontFamily：：GetFamilyNames 方法创建的本地化字体系列名称列表。 以下示例演示如何获取“en-us”区域设置的姓氏。

IDWriteLocalizedStrings* pFamilyNames = NULL;

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

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;

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

要求

要求	值
最低受支持的客户端	Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台	Windows
标头	dwrite.h