다음을 통해 공유

IAgentCharacterEx::SetLanguageID

  • 아티클

[Microsoft 에이전트는 Windows 7을 기준으로 더 이상 사용되지 않으며 이후 버전의 Windows에서는 사용할 수 없습니다.]

HRESULT SetLanguageID(
   long langID  // language ID setting of character
);

문자에 대해 설정된 언어 ID를 설정합니다.

  • 작업이 성공했음을 나타내는 S_OK 반환합니다.

Langid

문자의 언어 ID 설정입니다.

문자의 언어 ID를 지정하는 Long 정수입니다. 문자의 언어 ID(LANGID)는 Windows에서 정의한 16비트 값으로, 기본 언어 ID와 보조 언어 ID로 구성됩니다. 지정된 언어에 대해 다음 값을 사용할 수 있습니다. 자세한 내용은 플랫폼 SDK 설명서를 참조하세요.

언어 ID 언어 ID
아랍어(사우디) 0x0401 이탈리아어 0x0410
바스크어 0x042d 일본어 0x0411
중국어(간체) 0x0804 한국어 0x0412
중국어(번체) 0x0404 노르웨이어 0x0414
크로아티아어 0x041A 폴란드어 0x0415
체코어 0x0405 포르투갈어(포르투갈) 0x0816
덴마크어 0x0406 포르투갈어(브라질) 0x0416
네덜란드어 0x0413 루마니아어 0x0418
영어(영국) 0x0809 러시아어 0x0419
영어(미국) 0x0409 슬로바키아어 0x041B
핀란드어 0x040B 슬로베니아어 0x0424
프랑스어 0x040C 스페인어 0x0c0a
독일어 0x0407 스웨덴어 0x041D
그리스어 0x0408 태국어 0x041E
히브리어 0x040D 터키어 0x041F
헝가리어 0x040E    

 

문자의 언어 ID를 설정하지 않으면 해당 에이전트 언어 DLL이 설치된 경우 해당 언어 ID가 현재 시스템 언어 ID가 됩니다. 그렇지 않으면 문자의 언어가 영어(미국)가 됩니다.

또한 이 속성은 단어 풍선 텍스트의 언어, 문자의 팝업 메뉴에 있는 명령 및 음성 인식 엔진을 결정합니다. 또한 TTS 출력에 대한 기본 언어도 결정합니다. 문자의 언어에 사용할 수 있는 호환 음성 엔진이 있는지 확인하려면 IAgentCharacterEx::GetSRModeID 또는 IAgentCharacterEx::GetTTSModeID를 사용합니다.

문자 및 에이전트 언어 리소스, 코드 페이지 또는 언어 ID의 표시 글꼴에 대한 언어 ID를 설정할 수 없는 경우 에이전트는 오류를 반환하고 문자의 언어 ID는 마지막 설정에 유지됩니다. 언어에 일치하는 음성 엔진이 없으면 이 속성을 설정해도 오류가 반환되지 않습니다.

이 속성은 클라이언트 애플리케이션의 문자 사용에만 적용됩니다. 설정은 클라이언트 애플리케이션의 문자 또는 다른 문자의 다른 클라이언트에 영향을 주지 않습니다.

참고

문자의 언어 ID를 양방향 텍스트(예: 아랍어 또는 히브리어)를 지원하는 언어로 설정했지만 애플리케이션을 실행하는 시스템에 양방향 지원이 설치되어 있지 않으면 텍스트가 표시 순서가 아닌 논리적으로 단어 풍선에 표시됩니다.

 

참고 항목

IAgentCharacterEx:GetLanguageID, IAgentCharacterEx::GetSRModeID, IAgentCharacterEx::GetTTSModeID