Méthode ITextStoreAnchor::GetAnchorFromPoint (textstor.h)
La méthode ITextStoreAnchor::GetAnchorFromPoint convertit un point dans les coordonnées de l’écran en ancre positionnée à un emplacement correspondant.
Syntaxe
HRESULT GetAnchorFromPoint(
[in] TsViewCookie vcView,
[in] const POINT *ptScreen,
[in] DWORD dwFlags,
[out] IAnchor **ppaSite
);
Paramètres
[in] vcView
Spécifie la vue de contexte.
[in] ptScreen
Pointeur vers la structure POINT avec les coordonnées d’écran du point.
[in] dwFlags
Spécifie la position d’ancre à retourner en fonction des coordonnées d’écran du point par rapport à un cadre englobant de caractères. Par défaut, la position d’ancre 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.
[out] ppaSite
Pointeur vers un objet d’ancre à un emplacement correspondant aux coordonnées de l’écran ptScreen.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Valeur | Description |
|---|---|
|
La méthode a réussi. |
|
La méthode a échoué. |
|
Un ou plusieurs paramètres d’entrée n’est pas valide. |
|
La tentative d’instanciation d’une ancre à l’emplacement spécifié a échoué. |
|
Le paramètre ptScreen ne se trouve dans le cadre englobant d’aucun caractère. |
|
L’application n’a pas encore calculé de disposition de texte. |
Remarques
Les coordonnées d’écran du point 1 entraînent le décalage (position des caractères) de ppaSite d’ancre à 0 par défaut ou si le paramètre dwFlags est défini sur GXFPF_NEAREST , car les coordonnées d’écran 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 décalage d’ancre 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 du point 2 se trouvent en dehors d’un cadre englobant de caractères. Si le paramètre dwFlags est défini sur GXFPF_ROUND_NEAREST, les coordonnées d’écran du point 2 entraînent le décalage d’ancre à 1, 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 - Décalage d’ancre = 0 --Le point de coordonnées de l’écran se trouve à l’intérieur du cadre englobant de caractères de la position de caractère 0.
- -- GXFPF_ROUND_NEARESTdécalage d’ancre = 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_NEARESTdécalage d’ancre = 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.
- Default-- 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-- décalage d’ancre = 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 | Applications UWP] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | textstor.h |
| DLL | Msctf.dll |
| Composant redistribuable | TSF 1.0 sur Windows 2000 Professionnel |
Voir aussi
ITfContextView::GetRangeFromPoint