Méthode ITfContextOwner ::GetACPFromPoint (msctf.h)

La méthode ITfContextOwner ::GetACPFromPoint convertit un point dans les coordonnées de l’écran en position de caractère d’application.

Syntaxe

HRESULT GetACPFromPoint(
  [in]  const POINT *ptScreen,
  [in]  DWORD       dwFlags,
  [out] LONG        *pacp
);

Paramètres

[in] ptScreen

Pointeur vers la structure POINT avec les coordonnées d’écran du point.

[in] dwFlags

Spécifie la position de caractère à retourner en fonction des coordonnées d’écran du point par rapport à un cadre englobant de caractères. Par défaut, la position des caractères retournée est le cadre englobant contenant les coordonnées d’écran du point. Si le point se trouve en dehors du cadre englobant d’un caractère, la méthode retourne NULL ou TF_E_INVALIDPOINT.

Si l’indicateur GXFPF_ROUND_NEAREST est spécifié pour ce paramètre et que les coordonnées d’écran du point sont contenues dans un cadre englobant de caractères, la position de caractère retournée est le bord englobant le plus proche des coordonnées d’écran du point.

Si l’indicateur GXFPF_NEAREST est spécifié pour ce paramètre et que les coordonnées d’écran du point ne sont pas contenues dans un cadre englobant de caractères, la position de caractère la plus proche est retournée.

Les indicateurs de bits peuvent être combinés.

[out] pacp

Reçoit la position des caractères qui correspond aux coordonnées de l’écran du point

Valeur retournée

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

Valeur	Description
S_OK	La méthode a réussi.
TS_E_INVALIDPOINT	Le paramètre ptScreen ne se trouve dans le cadre englobant d’aucun caractère.
TS_E_NOLAYOUT	L’application n’a pas calculé de disposition de texte.

Remarques

Utilisez l’illustration pour déterminer la position des caractères retournée en fonction des indicateurs utilisés dans le paramètre dwFlags .

Point 1

• Valeur par défaut - pacp = 0 --Les coordonnées d’écran du point se trouvent à l’intérieur du cadre englobant de caractères de la position de caractère 0.
• GXFPF_ROUND_NEAREST-- pacp = 1 --Les coordonnées d’écran du point sont les plus proches de la position de plage 1, qui est la position de plage de départ de la position de caractère 1.
• GXFPF_NEAREST-- pacp = 0 --Le comportement par défaut se produit, car le point se trouve dans le cadre englobant de caractères de la position de caractère 0.

Point 2

• Valeur par défaut - hr = TF_E_INVALIDPOINT --Les coordonnées d’écran du point se trouvent en dehors d’un cadre englobant de caractères.
• GXFPF_ROUND_NEAREST-- hr = TF_E_INVALIDPOINT --Le comportement par défaut se produit car les coordonnées d’écran du point se trouvent en dehors d’un cadre englobant de caractères.
• GXFPF_NEAREST-- pacp = 1 --La position de caractère la plus proche des coordonnées d’écran du point est La position de caractère 1.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	msctf.h
DLL	Msimtf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

ITextStoreACP ::GetACPFromPoint

ITfContextOwner

ITfContextView ::GetRangeFromPoint

TsViewCookie