ITextStoreAnchor ::GetTextExt, méthode (textstor.h)

Article
03/04/2024

La méthode ITextStoreAnchor ::GetTextExt retourne le cadre englobant, en coordonnées d’écran, d’une plage de texte. L’appelant doit disposer d’un verrou en lecture seule sur le document avant d’appeler cette méthode.

Syntaxe

HRESULT GetTextExt(
  [in]  TsViewCookie vcView,
  [in]  IAnchor      *paStart,
  [in]  IAnchor      *paEnd,
  [out] RECT         *prc,
  [out] BOOL         *pfClipped
);

Paramètres

[in] vcView

Spécifie l’affichage contextuel.

[in] paStart

Spécifie l’ancre positionnée au début de la plage.

[in] paEnd

Spécifie l’ancre positionnée à la fin de la plage.

[out] prc

Reçoit le cadre englobant de la plage de texte en coordonnées d’écran.

[out] pfClipped

Reçoit une valeur booléenne qui spécifie si le texte du cadre englobant a été coupé. Si la valeur est TRUE, le cadre englobant contient du texte coupé et n’inclut pas la totalité de la plage de texte demandée. Le cadre englobant est coupé, car la plage demandée n’est pas visible.

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 n’a pas pu obtenir un pointeur d’interface valide vers les ancres de début et/ou de fin.
TS_E_INVALIDARG	Un ou plusieurs paramètres d’entrée ne sont pas valides.
TS_E_INVALIDPOS	La plage spécifiée par les paramètres paStart et paEnd s’étend au-delà du début ou de la fin du document.
TS_E_NOLAYOUT	L’application n’a pas calculé de disposition de texte. Tous les autres appels ne réussissent pas tant que l’application n’appelle pas ITextStoreAnchorSink ::OnLayoutChange.
TS_E_NOLOCK	L’appelant n’a pas de verrou en lecture seule sur le document.

Remarques

Si la fenêtre de document est réduite ou si le texte spécifié n’est pas visible actuellement, la méthode retourne S_OK avec le paramètre prc défini sur {0,0,0,0}.

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	textstor.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

ITextStoreAnchor

ITfContextOwner ::GetTextExt

ITfContextView ::GetTextExt

Partager via