Partager via


Méthode ITextInputPanel ::SetInPlaceHoverTargetPosition (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.

]

Positionne explicitement la cible de pointage du panneau d’entrée tablet PC dans les coordonnées de l’écran.

Syntaxe

HRESULT SetInPlaceHoverTargetPosition(
  int xPosition,
  int yPosition
);

Paramètres

xPosition

Coordonnée x horizontale pour le coin supérieur gauche de la cible de pointage, sans peigne de correction visible.

yPosition

Coordonnée y verticale du coin supérieur gauche de la cible de pointage, sans peigne de correction visible.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
Réussite.
E_FAIL
Une erreur non spécifiée s'est produite.

Remarques

Il n’existe aucune restriction sur l’emplacement où la cible de pointage peut être placée. L’application est chargée de s’assurer que la cible de pointage reste à l’écran.

La méthode SetInPlaceHoverTargetPosition est synchrone. Le positionnement se produit avant le retour de la méthode.

Exemples

Cet exemple C++ implémente un gestionnaire d’événements EN_SETFOCUS pour un contrôle Edit, IDC_EDIT2. Il vérifie d’abord si un objet ITextInputPanel , g_pTip, a été créé. S’il existe, il définit la position de la cible de pointage du panneau d’entrée en appelant la méthode ITextInputPanel ::SetInPlaceHoverTargetPosition. Il indique ensuite si l’appel a réussi à déboguer la sortie à l’aide de la macro TRACE .

void CCOMTIPDlg::OnEnSetfocusEdit2()
{
	if (NULL != g_pTip)
	{
		if (SUCCEEDED(g_pTip->SetInPlaceHoverTargetPosition(300, 300)))
		{
			TRACE("Call to SetInPlaceHoverTargetPosition() succeeded.\n");
		}
		else
		{
			TRACE("Call to SetInPlaceHoverTargetPosition() failed.\n");
		}
	}
    else
    {
        TRACE("ITextInputPanel object is NULL.\n");
    }
}

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP Édition Tablette PC [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête peninputpanel.h
DLL Tiptsf.dll

Voir aussi

ITextInputPanel, interface

ITextInputPanel ::SetInPlacePosition, méthode

ITextInputPanel ::SetInPlaceVisibility, méthode