ITextInputPanel：:p ut_PreferredInPlaceDirection 方法 (peninputpanel.h)

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

]

获取或设置就地输入面板相对于文本输入字段的首选方向。

此属性是可读写的。

语法

HRESULT put_PreferredInPlaceDirection(
  InPlaceDirection Direction
);

参数

Direction

返回值

无

备注

应用程序可以指定就地输入面板是默认显示在文本输入字段上方还是下方。 为此，应用程序可以将 ITextInputPanel：:P referredInPlaceDirection 属性 设置为 InPlaceDirection_Bottom 或 InPlaceDirection_Top。 ITextInputPanel：:P referredInPlaceDirection 属性 是一种首选项，因为就地输入面板将替代应用程序设置的首选项，以便在屏幕上保留输入面板。 系统默认在可能的情况下将就地输入面板置于文本字段下方，否则将它置于其上方。 将 PreferredInPlaceDirection 设置为 InPlaceDirection_Auto 将还原系统默认值。

示例

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

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 接口