iTextInputPanel::SetInPlaceHoverTargetPosition 方法 (peninputpanel.h)

[ITextInputPanel 可在“要求”部分指定的操作系统中使用。 它可能在后续版本中变更或不可用。 请改用 IInputPanelConfiguration

]

将平板电脑输入面板悬停目标显式定位在屏幕坐标中。

语法

HRESULT SetInPlaceHoverTargetPosition(
  int xPosition,
  int yPosition
);

参数

xPosition

悬停目标左上角的水平 x 坐标,没有可见的更正梳子。

yPosition

悬停目标左上角的垂直 y 坐标,没有可见的更正梳。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
成功。
E_FAIL
发生了未指定的错误。

注解

悬停目标的位置没有限制。 应用程序负责确保悬停目标停留在屏幕上。

SetInPlaceHoverTargetPosition 方法是同步的。 定位在方法返回之前发生。

示例

此 C++ 示例实现 EN_SETFOCUS Edit 控件 IDC_EDIT2的事件处理程序。 它首先检查是否已创建 ITextInputPanel 对象 g_pTip。 如果存在,则通过调用 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
标头 peninputpanel.h
DLL Tiptsf.dll

另请参阅

ITextInputPanel 接口

ITextInputPanel::SetInPlacePosition 方法

ITextInputPanel::SetInPlaceVisibility 方法