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 |