Méthode ITextStoreAnchor::GetAnchorFromPoint (textstor.h)

Article
08/26/2023

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.

Valeur	Signification
GXFPF_ROUND_NEAREST	Si les coordonnées d’écran du point sont contenues dans un cadre englobant de caractères, une ancre est retournée au 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, une ancre à la position de caractère la plus proche est retournée.

[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
S_OK	La méthode a réussi.
E_FAIL	La méthode a échoué.
E_INVALIDARG	Un ou plusieurs paramètres d’entrée n’est pas valide.
E_OUTOFMEMORY	La tentative d’instanciation d’une ancre à l’emplacement spécifié a échoué.
TS_E_INVALIDPOINT	Le paramètre ptScreen ne se trouve dans le cadre englobant d’aucun caractère.
TS_E_NOLAYOUT	L’application n’a pas encore 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 des caractères.

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.

Point 2

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