Поделиться через

Метод ITipAutocompleteClient::P referredRects

  • Статья

Позволяет клиенту предложить расположение списка автозаполнения, чтобы избежать перекрытия панели ввода.

Синтаксис

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. Перед вызовом метода это значение должно быть инициализировано в предпочтительной ориентации поставщика.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Успешно.
E_INVALIDARG
 Вызовите метод ITipAutocompleteClient::RequestShowUI , чтобы задать всплывающее окно списка автозаполнения перед вызовом метода ITipAutocompleteClient::P referredRects.
E_FAIL
 Произошла неизвестная ошибка.

Комментарии

Это метод, который вызывается поставщиком автозаполнения, когда он вот-вот покажет пользовательский интерфейс автозаполнения. Клиент изменяет предпочтительный прямоугольник поставщика, заданный prcACList , с помощью аргумента prcModified .

Вызовите метод ITipAutocompleteClient::RequestShowUI , чтобы задать дескриптор всплывающего окна автоматического завершения списка перед вызовом PreferredRects. В противном случае при вызове PreferredRects возникает ошибка E_INVALIDARG.

Требования

Требование Значение
Минимальная версия клиента
 Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера
 Ни одна версия не поддерживается
Заголовок
TipAutoComplete.h (также требуется Peninputpanel_i.c)
DLL
Tiptsf.dll

См. также раздел

Интерфейс ITipAutocompleteClient

Метод ITipAutocompleteClient::RequestShowUI

Справочник по панели ввода текста