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

Статья
08/25/2023

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

]

Возвращает текущую область ввода, указанную перечислением PanelInputArea.

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

Синтаксис

HRESULT get_CurrentInputArea(
  PanelInputArea *Area
);

Параметры

Area

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

None

Remarks

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

Примеры

В этом примере C++ реализуется EN_SETFOCUS обработчик событий для элемента управления Edit , IDC_EDIT3. Сначала проверяется, g_pTipбыл ли создан объект ITextInputPanel , . Если он существует, он сообщает значения нескольких свойств интерфейса ITextInputPanel для отладки выходных данных с помощью макроса TRACE .

void CCOMTIPDlg::OnEnSetFocusEdit3()
{
    if (NULL != g_pTip)
    {
		CorrectionMode mode;

		if (SUCCEEDED(g_pTip->get_CurrentCorrectionMode(&mode)))
        {
			TRACE("CurrentCorrectionMode: %d\n", mode);
		}

		InPlaceState state;

		if (SUCCEEDED(g_pTip->get_CurrentInPlaceState(&state)))
        {
			TRACE("CurrentInPlaceState: %d\n", state);
		}

		PanelInputArea area;

		if (SUCCEEDED(g_pTip->get_CurrentInputArea(&area)))
        {
			TRACE("CurrentInputArea: %d\n", area);
		}

		InteractionMode iMode;

		if (SUCCEEDED(g_pTip->get_CurrentInteractionMode(&iMode)))
        {
			TRACE("CurrentInteractionMode: %d\n", iMode);
		}

        RECT rect;

		if (SUCCEEDED(g_pTip->get_InPlaceBoundingRectangle(&rect)))
        {
	        TRACE("InPlaceBoundingRectangle.top: %d\n", rect.top);
	        TRACE("InPlaceBoundingRectangle.left: %d\n", rect.left);
	        TRACE("InPlaceBoundingRectangle.bottom: %d\n", rect.bottom);
	        TRACE("InPlaceBoundingRectangle.right: %d\n", rect.right);
        }

	    int nHeight;

		if (SUCCEEDED(g_pTip->get_PopDownCorrectionHeight(&nHeight)))
        {
	        TRACE("PopDownCorrectionHeight: %d\n", nHeight);
        }

	    if (SUCCEEDED(g_pTip->get_PopUpCorrectionHeight(&nHeight)))
        {
	        TRACE("PopUpCorrectionHeight: %d\n", nHeight);
        }

		if (SUCCEEDED(g_pTip->SetInPlacePosition(300, 300, CorrectionPosition_Bottom)))
		{
			TRACE("Call to SetInPlacePosition() succeeded.\n");
		}
		else
		{
			TRACE("Call to SetInPlacePosition() failed.\n");
		}
    }
    else
    {
        TRACE("ITextInputPanel object is NULL.\n");
    }
}

Требования

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

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

Интерфейс ITextInputPanel

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