Метод ITextInputPanel::p ut_PreferredInPlaceDirection (peninputpanel.h)

Статья
08/25/2023

[ITextInputPanel доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте IInputPanelConfiguration.

]

Возвращает или задает предпочтительное направление панели ввода на месте относительно поля ввода текста.

Это свойство доступно для чтения и записи.

Синтаксис

HRESULT put_PreferredInPlaceDirection(
  InPlaceDirection Direction
);

Параметры

Direction

Возвращаемое значение

None

Remarks

Приложение может указать, будет ли панель ввода на месте по умолчанию отображаться над полем ввода текста или под ним. Для этого приложение может задать для свойства ITextInputPanel::P referredInPlaceDirection значениеInPlaceDirection_Bottom или InPlaceDirection_Top. Свойство ITextInputPanel::P referredInPlaceDirection является предпочтением, так как панель ввода на месте переопределяет настройки, заданные приложением, когда необходимо сохранить панель ввода на экране. По умолчанию система размещает панель ввода на месте под текстовым полем, когда это возможно, и в противном случае — над ней. Если задать для PreferredInPlaceDirectionзначение InPlaceDirection_Auto , система по умолчанию восстанавливается.

Примеры

В этом примере C++ создается объект g_pTipITextInputPanel и он присоединяется к дескриптору окна элемента управления InkEdit, IDC_EDIT3путем задания свойства ITextInputPanel::AttachedEditWindow Property. Он также задает, а затем получает свойство 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");
    }
}

Требования

Требование	Значение
Минимальная версия клиента	Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	peninputpanel.h
DLL	Tiptsf.dll

См. также раздел

Интерфейс ITextInputPanel

Поделиться через