MÉTHODE IDWriteLocalizedStrings::FindLocaleName (dwrite.h)

Article
08/23/2023

Obtient l’index de base zéro de la paire nom/chaîne de paramètres régionaux avec le nom de paramètres régionaux spécifié.

Syntaxe

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

Paramètres

[in] localeName

Type : const WCHAR*

Tableau de caractères avec fin null contenant le nom des paramètres régionaux à rechercher.

[out] index

Type : UINT32*

Index de base zéro de la paire nom/chaîne de paramètres régionaux. Cette méthode initialise l’index en UINT_MAX.

[out] exists

Type : BOOL*

Lorsque cette méthode est retournée, contient TRUE si le nom des paramètres régionaux existe ; sinon, FALSE. Cette méthode initialise existe surFALSE.

Valeur retournée

Type : HRESULT

Si le nom de paramètres régionaux spécifié n’existe pas, la valeur de retour est S_OK, mais l’index est UINT_MAX et existe a la valeur FALSE.

Notes

Notez que si le nom des paramètres régionaux n’existe pas, la valeur de retour est une réussite et le paramètre exists est FALSE. Si vous obtenez le nom de la famille de polices d’une police et que le nom de paramètres régionaux spécifié n’existe pas, une option consiste à définir l’index sur 0 comme indiqué ci-dessous. Il existe toujours au moins un paramètre régional pour une famille de polices.

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;

Spécifications


Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	dwrite.h
Bibliothèque	Dwrite.lib
DLL	Dwrite.dll

Voir aussi

IDWriteLocalizedStrings

Partager via