Méthode ITfContextOwner ::GetTextExt (msctf.h)

La méthode ITfContextOwner ::GetTextExt retourne le cadre englobant, en coordonnées d’écran, du texte à une position de caractère spécifiée. L’appelant doit disposer d’un verrou en lecture seule sur le document avant d’appeler cette méthode.

Syntaxe

HRESULT GetTextExt(
  [in]  LONG acpStart,
  [in]  LONG acpEnd,
  [out] RECT *prc,
  [out] BOOL *pfClipped
);

Paramètres

[in] acpStart

Spécifie la position du caractère de départ du texte à obtenir dans le document.

[in] acpEnd

Spécifie la position du caractère de fin du texte à obtenir dans le document.

[out] prc

Reçoit le cadre englobant, en coordonnées d’écran, du texte aux positions de caractères spécifiées.

[out] pfClipped

Reçoit la valeur booléenne qui spécifie si le texte du cadre englobant a été coupé. Si ce paramètre a la valeur 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.
TS_E_INVALIDARG	Les positions des caractères de début et de fin spécifiées sont égales.
TS_E_INVALIDPOS	La plage spécifiée par les paramètres acpStart et acpEnd s’étend au-delà de la fin du document ou du haut du document.
TS_E_NOLAYOUT	L’application n’a pas calculé de disposition de texte.
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 uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	msctf.h
DLL	Msimtf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

ITextStoreACP ::GetTextExt

ITfContextOwner

ITfContextView ::GetTextExt