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

Статья
08/25/2023

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

]

Возвращает или задает значение, указывающее, отображается ли панель ввода планшетного компьютера автоматически, когда окно, к которому она подключена, получает фокус.

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

Синтаксис

HRESULT get_InPlaceVisibleOnFocus(
  BOOL *Visible
);

Параметры

Visible

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

None

Remarks

Если для элемента управления ITextInputPanel::InPlaceVisibleOnFocus Property установлено значение TRUE , то, когда элемент управления получает фокус, панель ввода планшетного компьютера автоматически отображается в перечислении InPlaceState по умолчанию при условии, что это легальная операция.

Можно предотвратить появление панели ввода на месте и значка панели ввода, задав для свойства ITextInputPanel::InPlaceVisibleOnFocus значениеFALSE. Если задать для него значение TRUE, он возвращается к системе по умолчанию, когда это возможно, при условии, что он не был отключен пользователем или групповая политика. Этот параметр полезен для приложений, которые включают пользовательские решения для ввода текста в качестве альтернативы панели ввода.

Значение по умолчанию — TRUE.

Примеры

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

Требования

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

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

Интерфейс ITextInputPanel

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