Méthode ITfContextView ::GetRangeFromPoint (msctf.h)

La méthode ITfContextView ::GetRangeFromPoint convertit un point, dans les coordonnées de l’écran, en une plage vide de texte positionnée à un emplacement correspondant.

Syntaxe

HRESULT GetRangeFromPoint(
  [in]  TfEditCookie ec,
  [in]  const POINT  *ppt,
  [in]  DWORD        dwFlags,
  [out] ITfRange     **ppRange
);

Paramètres

[in] ec

Spécifie le cookie de modification avec accès en lecture seule.

[in] ppt

Spécifie le point dans les coordonnées de l’écran.

[in] dwFlags

Spécifie la position de plage à retourner en fonction des coordonnées d’écran du point vers un cadre englobant de caractères. Par défaut, la position de plage 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. Les 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 plage 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 plage la plus proche est retournée.

[out] ppRange

Reçoit un pointeur vers l’interface ITfRange.

Valeur retournée

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

Valeur	Description
S_OK	La méthode a réussi.
TF_E_INVALIDPOINT	Le paramètre pptScreen ne couvre aucun texte de document.
TF_E_NOLAYOUT	L’application n’a pas calculé de disposition de texte.
TF_E_NOLOCK	Le cookie de modification spécifié n’est pas valide.

Remarques

Par défaut, la méthode retourne une plage positionnée à 0 pour le point 1 et TF_E_INVALIDPOINT pour le point 2. Si le paramètre dwFlags a la valeur GXFPF_ROUND_NEAREST, la méthode retourne la position de plage 1 pour le point 1. Si le paramètre dwFlags est défini sur GXFPF_NEAREST la méthode retourne la position de plage 2 pour le point 2.

Configuration requise

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

Voir aussi

GXFPF_NEAREST

GXFPF_ROUND_NEAREST

ITfContextView

TF_E_INVALIDPOINT