클라이언트에서 입력 패널이 겹치지 않도록 자동 완성 목록을 배치할 위치를 제안할 수 있습니다.
구문
HRESULT PreferredRects(
[in] RECT *prcACList,
[in] RECT *prcField,
[out] RECT *prcModified,
[in, out] BOOL *pfShownAboveTip
);
매개 변수
-
prcACList [in]
-
공급자의 기본 설정 위치와 자동 완성 목록 사용자 인터페이스의 크기를 나타내는 사각형(화면 좌표)입니다.
-
prcField [in]
-
포커스가 있는 필드의 위치와 크기를 나타내는 사각형(화면 좌표)입니다.
-
prcModified [out]
-
TIP의 현재 상태와 prcACList에서 지정한 기본 자동 완성 목록 위치 및 크기를 기반으로 하는 사각형입니다.
-
pfShownAboveTip [in, out]
-
수정 된 사각형이 텍스트 입력 패널의 대상 영역 위에 표시될 경우 TRUE이고, 그렇지 않으면 FALSE입니다. 이 값은 메서드가 호출되기 전에 공급자의 기본 방향으로 초기화되어야 합니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | Description |
|---|---|
|
성공. |
|
ITipAutocompleteClient::RequestShowUI 메서드를 호출하여 ITipAutocompleteClient::P referredRects 메서드를 호출하기 전에 팝업 자동 완성 목록 창을 설정합니다. |
|
지정되지 않은 오류가 발생했습니다. |
설명
자동 완성 공급자가 자동 완성 사용자 인터페이스를 표시하려고 할 때 호출하는 메서드입니다. 클라이언트는 prcModified 인수를 통해 prcACList에 지정된 공급자의 기본 설정 사각형을 수정합니다.
PreferredRects를 호출하기 전에 ITipAutocompleteClient::RequestShowUI 메서드를 호출하여 팝업 자동 완성 목록 창 핸들을 설정합니다. 이렇게 하지 않으면 PreferredRects를 호출할 때 E_INVALIDARG 오류가 발생합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
지원되는 버전 없음 |
| 헤더 |
|
| DLL |
|