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

Article
03/02/2024

Convertit un point dans les coordonnées de l’é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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	textstor.h
DLL	Msctf.dll