다음을 통해 공유


ITipAutocompleteClient::RequestShowUI 메서드

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

구문

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

매개 변수

hWndACList [in]

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

pfAllowShowing [out]

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

반환 값

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

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

설명

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

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

요구 사항

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

추가 정보

ITipAutocompleteClient 인터페이스

ITipAutocompleteClient::P referredRects 메서드

텍스트 입력 패널 참조