ITextInputPanel::SetInPlaceHoverTargetPosition 方法 (peninputpanel.h)
[ITextInputPanel 可用於需求一節中指定的操作系統。 它在後續版本中可能會變更或無法使用。 請改用 IInputPanelConfiguration。
]
明確地將平板電腦輸入面板暫留目標放在螢幕座標中。
語法
HRESULT SetInPlaceHoverTargetPosition(
int xPosition,
int yPosition
);
參數
xPosition
暫留目標左上角的水準 x 座標,沒有可見的更正組合。
yPosition
暫留目標左上角的垂直 Y 座標,沒有可見的更正組合。
傳回值
這個方法可以傳回其中一個值。
傳回碼 | 描述 |
---|---|
|
成功。 |
|
發生未指定的錯誤。 |
備註
暫留目標可以放置的位置沒有任何限制。 應用程式負責確定暫留目標停留在畫面上。
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 |