IDWriteLocalizedStrings::FindLocaleName-Methode (dwrite.h)

Artikel
08/23/2023

Ruft den nullbasierten Index des Gebietsschemanamens-Zeichenfolgenpaars mit dem angegebenen Gebietsschemanamen ab.

Syntax

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

Parameter

[in] localeName

Typ: const WCHAR*

Ein Null-endendes Array von Zeichen, das den Gebietsschemanamen enthält, nach dem gesucht werden soll.

[out] index

Typ: UINT32*

Der nullbasierte Index des Gebietsschemapaars Name/Zeichenfolge. Diese Methode initialisiert den Index für UINT_MAX.

[out] exists

Typ: BOOL*

Wenn diese Methode zurückgibt, enthält TRUE , wenn der Gebietsschemaname vorhanden ist. andernfalls FALSE. Diese Methode initialisiert aufFALSE.

Rückgabewert

Typ: HRESULT

Wenn der angegebene Gebietsschemaname nicht vorhanden ist, wird der Rückgabewert S_OK, aber index ist UINT_MAX und vorhanden ist FALSE.

Hinweise

Beachten Sie, dass der Rückgabewert erfolgreich und der parameter existsFALSE ist, wenn der Gebietsschemaname nicht vorhanden ist. Wenn Sie den Namen der Schriftfamilie für eine Schriftart erhalten und der angegebene Gebietsschemaname nicht vorhanden ist, können Sie den Index wie unten gezeigt auf 0 festlegen. Es gibt immer mindestens ein Gebietsschema für eine Schriftfamilie.

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;

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	dwrite.h
Bibliothek	Dwrite.lib
DLL	Dwrite.dll

Weitere Informationen

IDWriteLocalizedStrings

Freigeben über