다음을 통해 공유

IDWriteLocalizedStrings::FindLocaleName 메서드(dwrite.h)

  • 아티클

지정된 로캘 이름을 가진 로캘 이름/문자열 쌍의 인덱스(0부터 시작)를 가져옵니다.

구문

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

매개 변수

[in] localeName

형식: const WCHAR*

찾을 로캘 이름을 포함하는 null로 끝나는 문자 배열입니다.

[out] index

형식: UINT32*

로캘 이름/문자열 쌍의 인덱스(0부터 시작)입니다. 이 메서드는 인 덱 스를 UINT_MAX 초기화합니다.

[out] exists

형식: BOOL*

이 메서드가 반환되면 로캘 이름이 있으면 TRUE 를 포함합니다. 그렇지 않으면 FALSE입니다. 이 메서드를 초기화하면 FALSE로 존재합니다.

반환 값

형식: HRESULT

지정된 로캘 이름이 없으면 반환 값이 S_OK 인덱스가 UINT_MAXfalse입니다.

설명

로캘 이름이 없는 경우 반환 값은 성공이고 exists 매개 변수는 FALSE입니다. 글꼴의 글꼴 패밀리 이름을 가져오고 지정된 로캘 이름이 없는 경우 아래와 같이 인덱스 를 0으로 설정하는 옵션이 있습니다. 글꼴 패밀리에는 항상 하나 이상의 로캘이 있습니다.

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;

요구 사항

   
지원되는 최소 클라이언트 Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 dwrite.h
라이브러리 Dwrite.lib
DLL Dwrite.dll

추가 정보

IDWriteLocalizedStrings