ITextInputPanel：：get_InPlaceVisibleOnFocus 方法 (peninputpanel.h)

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

]

获取或设置一个值，该值指示平板电脑输入面板在连接到的窗口获得焦点时是否自动显示。

此属性是可读写的。

语法

HRESULT get_InPlaceVisibleOnFocus(
  BOOL *Visible
);

参数

Visible

返回值

无

备注

如果 控件的 ITextInputPanel：：InPlaceVisibleOnFocus 属性 设置为 TRUE ，则当控件获得焦点时，平板电脑电脑输入面板将自动显示在默认 InPlaceState 枚举 中，前提是它是合法操作。

通过将 ITextInputPanel：：InPlaceVisibleOnFocus 属性 设置为 FALSE，可以防止就地输入面板和输入面板图标出现。 如果用户或组策略未禁用它，则将其设置为“TRUE”，则会将其还原为系统默认显示（如果可能）。 此选项适用于包含自定义文本输入解决方案作为输入面板替代项的应用程序。

默认值为 TRUE。

示例

此 C++ 示例创建 ITextInputPanel 对象 g_pTip，并通过设置 ITextInputPanel：：AttachedEditWindow 属性将其附加到 InkEdit 控件IDC_EDIT3的窗口句柄。 它还设置，然后获取 ITextInputPanel：：InPlaceVisibleOnFocus 属性。

if (SUCCEEDED(CoInitialize(NULL)))
{
    if (SUCCEEDED(CoCreateInstance(CLSID_TextInputPanel, NULL, CLSCTX_INPROC, IID_ITextInputPanel, (VOID**)&g_pTip)))
    {
        if (SUCCEEDED(g_pTip->put_AttachedEditWindow(GetDlgItem(IDC_EDIT3)->m_hWnd)))
        {
            g_pTip->put_DefaultInPlaceState(InPlaceState_Expanded);
            InPlaceState ips;
            g_pTip->get_DefaultInPlaceState(&ips);
            TRACE("DefaultInplaceState: %d\n", ips);
            
            g_pTip->put_DefaultInputArea(PanelInputArea_CharacterPad);
            PanelInputArea pia;
            g_pTip->get_DefaultInputArea(&pia);
            TRACE("DefaultInputArea: %d\n", pia);

            g_pTip->put_ExpandPostInsertionCorrection(FALSE);
            BOOL epic;
            g_pTip->get_ExpandPostInsertionCorrection(&epic);
            TRACE("ExpandPostInsertionCorrection: %d\n", epic);

            g_pTip->put_InPlaceVisibleOnFocus(TRUE);
            BOOL ipvof;
            g_pTip->get_InPlaceVisibleOnFocus(&ipvof);
            TRACE("InPlaceVisibleOnFocus: %d\n", ipvof);

            g_pTip->put_PreferredInPlaceDirection(InPlaceDirection_Top);
            InPlaceDirection direction;
            g_pTip->get_PreferredInPlaceDirection(&direction);
            TRACE("PreferredInPlaceDirection: %d\n", direction);
        }
    }
    else
    {
        TRACE("Failed to create ITextInputPanel object.\n");
    }
}

要求

另请参阅

ITextInputPanel 接口