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 |
|---|---|
|
La méthode a réussi. |
|
Les positions des caractères de début et de fin spécifiées sont égales. |
|
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. |
|
L’application n’a pas calculé de disposition de texte. |
|
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 |