Метод ITextInputPanel::SetInPlaceHoverTargetPosition (peninputpanel.h)

Статья
08/25/2023

[ITextInputPanel доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте IInputPanelConfiguration.

]

Явным образом размещает целевой объект панели ввода планшетного пк в координатах экрана.

Синтаксис

HRESULT SetInPlaceHoverTargetPosition(
  int xPosition,
  int yPosition
);

Параметры

xPosition

Горизонтальная координата по оси X для верхнего левого угла целевого объекта при наведении указателя мыши без видимой расчески коррекции.

yPosition

Вертикальная координата по оси Y для верхнего левого угла целевого объекта при наведении курсора без видимой расчески коррекции.

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

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

Код возврата	Описание
S_OK	Успешно.
E_FAIL	Произошла неизвестная ошибка.

Нет никаких ограничений на то, где можно разместить целевой объект при наведении указателя мыши. Приложение отвечает за то, чтобы целевой объект при наведении курсора оставался на экране.

Метод SetInPlaceHoverTargetPosition является синхронным. Позиционирование выполняется перед возвратом метода.

Примеры

В этом примере C++ реализуется EN_SETFOCUS обработчик событий для элемента управления Edit , IDC_EDIT2. Сначала проверяется, g_pTipбыл ли создан объект ITextInputPanel , . Если он существует, он задает позицию целевого объекта наводки панели ввода путем вызова метода ITextInputPanel::SetInPlaceHoverTargetPosition. Затем он сообщает, был ли вызов успешным для отладки выходных данных с помощью макроса TRACE .

void CCOMTIPDlg::OnEnSetfocusEdit2()
{
	if (NULL != g_pTip)
	{
		if (SUCCEEDED(g_pTip->SetInPlaceHoverTargetPosition(300, 300)))
		{
			TRACE("Call to SetInPlaceHoverTargetPosition() succeeded.\n");
		}
		else
		{
			TRACE("Call to SetInPlaceHoverTargetPosition() failed.\n");
		}
	}
    else
    {
        TRACE("ITextInputPanel object is NULL.\n");
    }
}

Требования

Требование	Значение
Минимальная версия клиента	Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	peninputpanel.h
DLL	Tiptsf.dll

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

Интерфейс ITextInputPanel

Метод ITextInputPanel::SetInPlacePosition

Метод ITextInputPanel::SetInPlaceVisibility

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