ITextInputPanel：：SetInPlaceVisibility 方法 (peninputpanel.h)

發行項
03/13/2024

[ITextInputPanel 可用於需求一節中指定的操作系統。它在後續版本中可能會變更或無法使用。請改用 IInputPanelConfiguration。

]

顯示或隱藏平板電腦輸入面板。

語法

HRESULT SetInPlaceVisibility(
  BOOL Visible
);

參數

Visible

TRUE 表示輸入面板; FALSE 隱藏輸入面板。

傳回值

如果輸入面板可以顯示，此方法會 傳回S_OK，否則 E_FAIL。如需輸入面板何時可以和無法受到 ITextInputPanel：：SetInPlaceVisibility 方法影響的詳細資訊，請參閱一節。

傳回碼	描述
S_OK	成功。
E_FAIL	發生未指定的錯誤。

備註

輸入面板會顯示為 ITextInputPanel：：CurrentInPlaceState 屬性所指定。

如果輸入面板已經顯示，呼叫 ITextInputPanel：：SetInPlaceVisibility 方法 ， 且 Visible 參數設定為 TRUE 將會失敗。

如果使用者已從 [輸入面板選項] 對話框停用就地模式，則呼叫 ITextInputPanel：：SetInPlaceVisibility 方法 將會失敗。

當可見度變更時，輸入面板中已有的任何筆跡都會自動插入。

這個方法不會變更 ITextInputPanel：：InPlaceVisibleOnFocus 屬性的值，而後續的焦點變更時，行為會還原為 ITextInputPanel：：InPlaceVisibleOnFocus 屬性所指定的行為。

ITextInputPanel：：SetInPlaceVisibility 方法是同步呼叫。在呼叫傳回之前，輸入面板可見度將會變更。

範例

這個 C++ 範例會實作 EN_SETFOCUS 編輯控制元件 IDC_EDIT1的事件處理程式。它會先檢查是否已建立 ITextInputPanel 物件 g_pTip。如果存在，則會防止輸入面板顯示，方法是呼叫 ITextInputPanel：：SetInPlaceVisibility 方法，並針對 Visible 參數呼叫 false 值。

void CCOMTIPDlg::OnEnSetfocusEdit1()
{
	if (NULL != g_pTip)
	{
		if (SUCCEEDED(g_pTip->SetInPlaceVisibility(false)))
		{
			TRACE("Successfully hid the Input Panel.\n");
		}
	}
}

規格需求

需求	值
最低支援的用戶端	Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	peninputpanel.h
Dll	Tiptsf.dll