IDWriteLocalizedStrings インターフェイス
ロケール名でインデックス処理された文字列のコレクションを表します。
メンバー
IDWriteLocalizedStrings インターフェイス の継承元は次のとおりです: IUnknown インターフェイス. IDWriteLocalizedStrings は次のメンバーも定義します:
- メソッド
メソッド
IDWriteLocalizedStrings インターフェイス は次の項目を定義します: メソッド.
メソッド | 説明 |
---|---|
FindLocaleName | 指定されたロケール名を使用して、ロケールの名前と文字列のペアの 0 から始まるインデックスを取得します。 |
GetCount | 言語と文字列のペアの数を取得します。 |
GetLocaleName | 指定されたインデックスを持つロケール名を指定された配列にコピーします。 |
GetLocaleNameLength | 指定されたインデックスを持つロケール名の長さ (null 終端文字を除く文字数) を取得します。 |
GetString | 指定されたインデックスを持つ文字列を指定された配列にコピーします。 |
GetStringLength | 指定されたインデックスを持つ文字列の長さ (null 終端文字を除く文字数) を取得します。 |
解説
IDWriteLocalizedStrings によって表される文字列のセットは、ロケールにマップされる 0 から始まる 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, Windows Vista SP2 および Windows Vista 用のプラットフォーム更新プログラム |
サーバーの最小要件 |
Windows Server 2008 R2, Windows Server 2008 SP2 および Windows Server 2008 用のプラットフォーム更新プログラム |
ヘッダー |
Dwrite.h |
ライブラリ |
Dwrite.lib |
DLL |
Dwrite.dll |