Compartir a través de


Método ITextInputPanel::get_CurrentInputArea (peninputpanel.h)

[ITextInputPanel está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use IInputPanelConfiguration.

]

Obtiene el área de entrada actual especificada por la enumeración PanelInputArea.

Esta propiedad es de solo lectura.

Sintaxis

HRESULT get_CurrentInputArea(
  PanelInputArea *Area
);

Parámetros

Area

Valor devuelto

None

Observaciones

El área de entrada actual es diferente del área de entrada predeterminada cuando el usuario ha cambiado explícitamente las áreas de entrada. También es diferente si el área de entrada predeterminada no está disponible porque el reconocedor actual no admite ese modo o porque no hay ningún reconocedor para el idioma de entrada actual. Cuando el Panel de entrada del PC tableta está cerrado o oculto, las áreas de entrada actuales se restablecen para que sean iguales al área de entrada predeterminada, a menos que el estado predeterminado sea Automático, en cuyo caso, el área de entrada actual no se restablece y representa el último área de entrada visible.

Ejemplos

En este ejemplo de C++ se implementa un EN_SETFOCUS controlador de eventos para un control Edit, IDC_EDIT3. Primero comprueba si se ha creado un objeto ITextInputPanel , g_pTip, . Si existe, notifica los valores de varias propiedades de ITextInputPanel Interface para depurar la salida mediante la macro 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");
    }
}

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado peninputpanel.h
Archivo DLL Tiptsf.dll

Consulte también

ITextInputPanel (interfaz)