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

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

]

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

Это свойство является чтением и записью.

Синтаксис

HRESULT get_PreferredInPlaceDirection(
  InPlaceDirection *Direction
);

Параметры

Direction

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

None

Remarks

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

Примеры

В этом примере C++ создается объект g_pTipITextInputPanel и он присоединяется к дескриптору окна элемента управления IDC_EDIT3InkEdit путем задания свойства 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");
    }
}

Требования

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

Интерфейс ITextInputPanel