iTextInputPanel：：SetInPlaceVisibility 方法 (peninputpanel.h)

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

]

显示或隐藏平板电脑输入面板。

语法

HRESULT SetInPlaceVisibility(
  BOOL Visible
);

参数

Visible

如果为 TRUE ，则显示输入面板; 如果为 FALSE ，则隐藏输入面板。

返回值

如果输入面板可以显示，该方法将返回 S_OK，否则 E_FAIL。 有关输入面板何时可以和不能受 ITextInputPanel：：SetInPlaceVisibility 方法影响的详细信息，请参阅“备注”部分。

注解

输入面板按 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");
		}
	}
}

要求

另请参阅

ITextInputPanel 接口

ITextInputPanel：:D efaultInPlaceState 属性

ITextInputPanel：：SetInPlaceHoverTargetPosition 方法

ITextInputPanel：：SetInPlacePosition 方法

InPlaceState 枚举