ITextInputPanel：：get_CurrentInputArea 方法 (peninputpanel.h)

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

]

获取 由 PanelInputArea 枚举指定的当前输入区域。

此属性为只读。

语法

HRESULT get_CurrentInputArea(
  PanelInputArea *Area
);

参数

Area

返回值

无

备注

当用户显式切换输入区域时，当前输入区域不同于默认输入区域。 如果默认输入区域不可用，则此模式也有所不同，因为当前识别器不支持该模式，或者因为当前输入语言没有识别器。 当平板电脑输入面板关闭或隐藏时，当前输入区域将重置为等于默认输入区域，除非默认状态为 “自动”，在这种情况下，当前输入区域不会重置，并且表示最后一个可见的输入区域。

示例

此 C++ 示例实现 EN_SETFOCUS Edit 控件 IDC_EDIT3的事件处理程序。 它首先检查是否已创建 ITextInputPanel 对象 g_pTip。 如果存在，它会报告多个 ITextInputPanel 接口 属性的值，以便使用 TRACE 宏调试输出。

void CCOMTIPDlg::OnEnSetFocusEdit3()
{
    if (NULL != g_pTip)
    {
		CorrectionMode mode;

		if (SUCCEEDED(g_pTip->get_CurrentCorrectionMode(&mode)))
        {
			TRACE("CurrentCorrectionMode: %d\n", mode);
		}

		InPlaceState state;

		if (SUCCEEDED(g_pTip->get_CurrentInPlaceState(&state)))
        {
			TRACE("CurrentInPlaceState: %d\n", state);
		}

		PanelInputArea area;

		if (SUCCEEDED(g_pTip->get_CurrentInputArea(&area)))
        {
			TRACE("CurrentInputArea: %d\n", area);
		}

		InteractionMode iMode;

		if (SUCCEEDED(g_pTip->get_CurrentInteractionMode(&iMode)))
        {
			TRACE("CurrentInteractionMode: %d\n", iMode);
		}

        RECT rect;

		if (SUCCEEDED(g_pTip->get_InPlaceBoundingRectangle(&rect)))
        {
	        TRACE("InPlaceBoundingRectangle.top: %d\n", rect.top);
	        TRACE("InPlaceBoundingRectangle.left: %d\n", rect.left);
	        TRACE("InPlaceBoundingRectangle.bottom: %d\n", rect.bottom);
	        TRACE("InPlaceBoundingRectangle.right: %d\n", rect.right);
        }

	    int nHeight;

		if (SUCCEEDED(g_pTip->get_PopDownCorrectionHeight(&nHeight)))
        {
	        TRACE("PopDownCorrectionHeight: %d\n", nHeight);
        }

	    if (SUCCEEDED(g_pTip->get_PopUpCorrectionHeight(&nHeight)))
        {
	        TRACE("PopUpCorrectionHeight: %d\n", nHeight);
        }

		if (SUCCEEDED(g_pTip->SetInPlacePosition(300, 300, CorrectionPosition_Bottom)))
		{
			TRACE("Call to SetInPlacePosition() succeeded.\n");
		}
		else
		{
			TRACE("Call to SetInPlacePosition() failed.\n");
		}
    }
    else
    {
        TRACE("ITextInputPanel object is NULL.\n");
    }
}

要求

要求	值
最低受支持的客户端	Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	peninputpanel.h
DLL	Tiptsf.dll

另请参阅

ITextInputPanel 接口