Share via

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 方法