ITipAutocompleteClient::RequestShowUI 메서드

입력 패널이 자동 완성 목록을 표시할 준비가 되었는지 여부를 결정합니다.

구문

HRESULT RequestShowUI(
  [in]  HWND hWndACList,
  [out] BOOL *pfAllowShowing
);

매개 변수

hWndACList [in]

자동 완성 목록 사용자 인터페이스의 창 핸들입니다.

pfAllowShowing [out]

FALSE 이면 클라이언트에서 자동 완성 목록 사용자 인터페이스를 표시하지 않는 것이 좋습니다. TRUE 이면 자동 완성 공급자가 목록 사용자 인터페이스를 표시할 수 있습니다.

반환 값

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

반환 코드 Description
S_OK
성공.
E_FAIL
지정되지 않은 오류가 발생했습니다.

설명

이 메서드는 자동 완성 사용자 인터페이스를 표시하려고 할 때 자동 완성 공급자에 의해 호출됩니다. 클라이언트의 내부 상태에서 공급자가 사용자 인터페이스를 표시할 수 없으면 pfAllowShowing 이 FALSE로 설정됩니다. 예를 들어 태블릿 PC 입력 패널의 필기 스킨에서 텍스트가 필드로 전송되고 사용자가 즉시 수동 입력을 시작하면 클라이언트는 pfAllowShowing 을 FALSE로 설정하여 사용자의 수동 입력을 소멸하지 않도록 자동 완성 사용자 인터페이스를 표시하지 않는 것이 좋습니다.

RequestShowUI를 호출하여 ITipAutocompleteClient::P referredRects 메서드를 호출하기 전에 팝업 자동 완성 목록 창 핸들을 설정합니다. 이렇게 하지 않으면 PreferredRects를 호출할 때 E_INVALIDARG 오류가 발생합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버
지원되는 버전 없음
헤더
TipAutoComplete.h(Peninputpanel_i.c도 필요)
DLL
Tiptsf.dll

추가 정보

ITipAutocompleteClient 인터페이스

ITipAutocompleteClient::P referredRects 메서드

텍스트 입력 패널 참조