Méthode ITextStoreACP::GetACPFromPoint (textstor.h)
La méthode ITextStoreACP::GetACPFromPoint convertit un point dans les coordonnées d’écran en position de caractère d’application.
Syntaxe
HRESULT GetACPFromPoint(
[in] TsViewCookie vcView,
[in] const POINT *ptScreen,
[in] DWORD dwFlags,
[out] LONG *pacp
);
Paramètres
[in] vcView
Spécifie l’affichage contextuel.
[in] ptScreen
Pointeur vers la structure POINT avec les coordonnées d’écran du point.
[in] dwFlags
Spécifie la position du 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 du caractère retournée est le cadre englobant de caractères contenant les coordonnées d’écran du point. Si le point se trouve en dehors d’un cadre englobant de caractères, la méthode retourne NULL ou TF_E_INVALIDPOINT. D’autres indicateurs de bits pour ce paramètre sont les suivants.
Les indicateurs de bits peuvent être combinés.
[out] pacp
Reçoit la position du caractère qui correspond aux coordonnées d’écran du point.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Valeur | Description |
|---|---|
|
La méthode a réussi. |
|
Le paramètre ptScreen ne se trouve pas dans le cadre englobant d’un caractère quelconque. |
|
L’application n’a pas calculé de disposition de texte. |
Remarques
Les coordonnées d’écran du point 1 font que le paramètre pacp est égal à 0 par défaut ou si le paramètre dwFlags est défini sur GXFPF_NEAREST , car les coordonnées d’écran du point 1 se trouvent à l’intérieur du cadre englobant de caractères de la position de caractère 0. Si le paramètre dwFlags est défini sur GXFPF_ROUND_NEAREST pour le point 1, le paramètre pacp est 1, car les coordonnées d’écran du point 1 sont les plus proches de la position de plage 1. La position de plage 1 est la position de plage de départ de la position de caractère 1.
Pour les coordonnées d’écran point 2, la méthode retourne TF_E_INVALIDPOINT par défaut ou si le paramètre dwFlags est défini sur GXFPF_NEAREST car les coordonnées d’écran point 2 se trouvent en dehors d’un cadre englobant de caractères. Si le paramètre dwFlags a la valeur GXFPF_ROUND_NEAREST, les coordonnées d’écran du point 2 entraînent la valeur 1 du paramètre pacp , car la position de caractère la plus proche des coordonnées d’écran du point 2 est la position de caractère 1.
Point 1
- Par défaut - pacp = 0 --Le point de coordonnées de l’écran se trouve à l’intérieur du cadre englobant des caractères de la position 0 du caractère.
- -- GXFPF_ROUND_NEARESTpacp = 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_NEARESTpacp = 0 :-Le comportement par défaut se produit, car le point se trouve dans le cadre englobant de caractères de la position 0 du caractère.
- 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 position de caractère 1.
Configuration requise
| 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 | textstor.h |
| DLL | Msctf.dll |
| Composant redistribuable | TSF 1.0 sur Windows 2000 Professionnel |
Voir aussi
ITfContextOwner::GetACPFromPoint
ITfContextView::GetRangeFromPoint