ITfUIElementSink::BeginUIElement 메서드(msctf.h)

ITfUIElementSink::BeginUIElement 메서드는 UIElement가 시작될 때 호출됩니다. 이 싱크를 사용하면 textservice가 UI 요소를 그릴지 여부를 그릴 수 있습니다.

구문

HRESULT BeginUIElement(
  [in] DWORD dwUIElementId,
       BOOL  *pbShow
);

매개 변수

[in] dwUIElementId

[in] 시작된 UIElement의 ID입니다.

pbShow

[in, out] 애플리케이션이 UIElement 콘텐츠를 그리지 않고 텍스트 서비스가 원래 UI 콘텐츠를 그리면 true 를 반환합니다. 애플리케이션이 UIElement의 콘텐츠를 그리고 텍스트 서비스에서 그리기를 중지하면 false 를 반환합니다. 애플리케이션은 ITfUIElementMgr::GetUIElement를 사용하여 ITfUIElement 인터페이스를 가져올 수 있으며 IID_ITfCandidateListUIElement 또는 다른 UIElement 인터페이스를 사용하여 QI별 UIElement를 처리할 수 있는지 평가할 수 있습니다. 애플리케이션을 알 수 없거나 처리할 수 없는 경우 항상 FALSE 를 반환할 수 있습니다. 이 경우 텍스트 서비스에 화면에 추가 UI가 표시되지 않습니다. 이는 일부 전체 화면 애플리케이션에 적합한 방법입니다. 또는 애플리케이션이 TRUE 를 반환하여 일부 특정 또는 알 수 없는 UI에서 TextService의 UI를 사용할 수 있습니다.

반환 값

TSF 관리자는 이 메서드의 반환 값을 무시합니다.

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.

요구 사항

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