Méthode ITextStoreACP ::GetTextExt (textstor.h)

Article
03/02/2024

La méthode ITextStoreACP ::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]  TsViewCookie vcView,
  [in]  LONG         acpStart,
  [in]  LONG         acpEnd,
  [out] RECT         *prc,
  [out] BOOL         *pfClipped
);

Paramètres

[in] vcView

Spécifie la vue de contexte.

[in] acpStart

Spécifie la position de 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 dans les coordonnées d’écran du texte aux positions de caractères spécifiées.

[out] pfClipped

Reçoit une valeur booléenne qui spécifie si le texte du cadre englobant a été rogné. Si ce paramètre a la valeur TRUE, le cadre englobant contient du texte rogné 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 de début et de fin des caractères spécifiées sont égales.
TS_E_INVALIDPOS	La plage spécifiée par les paramètres acpStart et acpEnd 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.
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	textstor.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

ITextStoreACP

ITfContextOwner ::GetTextExt

ITfContextView ::GetTextExt

Partager via