IDWriteLocalizedStrings インターフェイス (dwrite.h)

ロケール名でインデックス付けされた文字列のコレクションを表します。

継承

IDWriteLocalizedStrings インターフェイスは、IUnknown インターフェイスから継承します。 IDWriteLocalizedStrings には、 次の種類のメンバーもあります。

メソッド

IDWriteLocalizedStrings インターフェイスには、これらのメソッドがあります。

IDWriteLocalizedStrings::FindLocaleName 指定したロケール名を持つロケール名と文字列のペアの 0 から始まるインデックスを取得します。
IDWriteLocalizedStrings::GetCount 言語と文字列のペアの数を取得します。
IDWriteLocalizedStrings::GetLocaleName 指定したインデックスを持つロケール名を、指定した配列にコピーします。 (IDWriteLocalizedStrings.GetLocaleName)
IDWriteLocalizedStrings::GetLocaleNameLength 指定したインデックスを持つロケール名の文字数 (null 終端記号を含まない) を取得します。 (IDWriteLocalizedStrings.GetLocaleNameLength)
IDWriteLocalizedStrings::GetString 指定したインデックスを持つ文字列を、指定した配列にコピーします。 (IDWriteLocalizedStrings.GetString)
IDWriteLocalizedStrings::GetStringLength 指定したインデックスを持つ文字列の文字数 (null 終端記号を含まない) を取得します。 (IDWriteLocalizedStrings.GetStringLength)

注釈

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 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	dwrite.h