ITfThreadMgrEx::ActivateEx 메서드(msctf.h)

  • 아티클

ITfThreadMgrEx::ActivateEx 메서드는 애플리케이션에서 호출 스레드에 대한 TSF를 초기화하고 활성화하는 데 사용됩니다. ITfThreadMgr::Activate와 달리 ITfThreadMgrEx::ActivateEx는 플래그를 사용하여 TSF가 활성화되는 방법을 지정할 수 있습니다.

구문

HRESULT ActivateEx(
  [out] TfClientId *ptid,
  [in]  DWORD      dwFlags
);

매개 변수

[out] ptid

[out] 클라이언트 식별자를 수신하는 TfClientId 값에 대한 포인터입니다.

[in] dwFlags

값 의미
TF_TMAE_NOACTIVATETIP
 ITfThreadMgrEx::ActivateEx가 호출되는 동안에는 텍스트 서비스가 활성화되지 않습니다. 호출 스레드에 포커스가 비동기적으로 있을 때 활성화됩니다.
TF_TMAE_SECUREMODE
 TSF는 보안 모드에서 활성화됩니다. 보안 모드를 지원하는 텍스트 서비스만 활성화됩니다.
TF_TMAE_UIELEMENTENABLEDONLY
 TSF는 GUID_TFCAT_TIPCAP_UIELEMENTENABLED 분류된 텍스트 서비스만 활성화합니다.
TF_TMAE_COMLESS
 TSF는 COM을 사용하지 않습니다. TSF는 GUID_TFCAT_TIPCAP_COMLESS 분류된 텍스트 서비스만 활성화합니다.
TF_TMAE_NOACTIVATEKEYBOARDLAYOUT
 ITfThreadMgrEx::ActivateEx()가 호출되는 동안 TSF는 현재 키보드 레이아웃을 동기화하지 않습니다. 호출 스레드가 포커스를 받으면 키보드 레이아웃이 조정됩니다. 이 플래그는 TF_TMAE_NOACTIVATETIP 함께 사용해야 합니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

값 Description
S_OK
 메서드를 성공적으로 수행했습니다.
E_FAIL
 지정되지 않은 오류가 발생했습니다.
E_INVALIDARG
 하나 이상의 매개 변수가 잘못되었습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 msctf.h
DLL Msctf.dll
재배포 가능 파일 Windows 2000 Professional의 TSF 1.0

추가 정보

ITfThreadMgr::Activate

ITfThreadMgrEx