Partager via


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