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

[ITextInputPanel est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt IInputPanelConfiguration.

]

Obtient la zone d’entrée actuelle spécifiée par l’énumération PanelInputArea.

Cette propriété est en lecture seule.

Syntaxe

HRESULT get_CurrentInputArea(
  PanelInputArea *Area
);

Paramètres

Area

Valeur de retour

None

Remarques

La zone d’entrée actuelle est différente de la zone d’entrée par défaut lorsque l’utilisateur a explicitement changé de zone d’entrée. Il est également différent si la zone d’entrée par défaut n’est pas disponible, car le module de reconnaissance actuel ne prend pas en charge ce mode ou parce qu’il n’existe aucun module de reconnaissance pour la langue d’entrée actuelle. Lorsque le panneau d’entrée tablette PC est fermé ou masqué, les zones d’entrée actuelles sont réinitialisées à la zone d’entrée par défaut, sauf si l’état par défaut est Auto, auquel cas, la zone d’entrée actuelle n’est pas réinitialisée et représente la dernière zone d’entrée visible.

Exemples

Cet exemple C++ implémente un gestionnaire d’événements EN_SETFOCUS pour un contrôle Edit, IDC_EDIT3. Il vérifie d’abord si un objet ITextInputPanel , g_pTip, a été créé. S’il existe, il signale les valeurs de plusieurs propriétés de l’interface ITextInputPanel pour déboguer la sortie à l’aide de 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");
    }
}

Configuration requise

Voir aussi

ITextInputPanel, interface