Méthode ITextStoreACP::GetACPFromPoint (textstor.h)

Article
08/26/2023

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.

Valeur	Signification
GXFPF_ROUND_NEAREST	Si 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.
GXFPF_NEAREST	Si 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.

[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
S_OK	La méthode a réussi.
TS_E_INVALIDPOINT	Le paramètre ptScreen ne se trouve pas dans le cadre englobant d’un caractère quelconque.
TS_E_NOLAYOUT	L’application n’a pas calculé de disposition de texte.

Remarques

Le point 1 se trouve dans le cadre englobant de caractères et le point 2 se trouve en dehors du cadre englobant de caractères.

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.

Point 2

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