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 属性指定的方式显示。

如果输入面板已可见，则调用 Visible 参数设置为 TRUE 的 ITextInputPanel：：SetInPlaceVisibility 方法将失败。

如果用户已从“输入面板选项”对话框中禁用就地模式，则调用 ITextInputPanel：：SetInPlaceVisibility 方法 将失败。

当可见性更改时，将自动插入输入面板中已有的任何墨迹。

此方法不会更改 ITextInputPanel：：InPlaceVisibleOnFocus 属性的值，在后续焦点更改时，该行为将还原为 ITextInputPanel：：InPlaceVisibleOnFocus 属性指定的行为。

ITextInputPanel：：SetInPlaceVisibility 方法是同步调用。输入面板可见性将在调用返回之前更改。

示例

此 C++ 示例实现 EN_SETFOCUS Edit 控件 IDC_EDIT1的事件处理程序。它首先检查是否已创建 ITextInputPanel 对象 g_pTip。如果存在，则通过对 Visible 参数调用值为 false 的 ITextInputPanel：：SetInPlaceVisibility 方法，阻止输入面板显示。

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