METODE IDWriteLocalizedStrings::FindLocaleName (dwrite.h)

Mendapatkan indeks berbasis nol dari pasangan nama/string lokal dengan nama lokal yang ditentukan.

Sintaks

HRESULT FindLocaleName(
  [in]  WCHAR const *localeName,
  [out] UINT32      *index,
  [out] BOOL        *exists
);

Parameter

[in] localeName

Jenis: const WCHAR*

Array karakter yang dihentikan null yang berisi nama lokal untuk dicari.

[out] index

Jenis: UINT32*

Indeks berbasis nol dari pasangan nama/string lokal. Metode ini menginisialisasi indeks ke UINT_MAX.

[out] exists

Jenis: BOOL*

Ketika metode ini kembali, berisi TRUE jika nama lokal ada; jika tidak, FALSE. Metode ini menginisialisasi ada untuk FALSE.

Menampilkan nilai

Jenis: HRESULT

Jika nama lokal yang ditentukan tidak ada, nilai yang dikembalikan S_OK, tetapi indeksUINT_MAX dan ada adalah FALSE.

Keterangan

Perhatikan bahwa jika nama lokal tidak ada, nilai yang dikembalikan adalah keberhasilan dan parameter yang ada adalah FALSE. Jika Anda mendapatkan nama keluarga font untuk font dan nama lokal yang ditentukan tidak ada, salah satu opsinya adalah mengatur indeks ke 0 seperti yang ditunjukkan di bawah ini. Selalu ada setidaknya satu lokal untuk keluarga font.

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;

Persyaratan

Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	dwrite.h
Pustaka	Dwrite.lib
DLL	Dwrite.dll

Lihat juga

IDWriteLocalizedStrings