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

Article
08/26/2023

Obtient 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 l’affichage contextuel.

[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 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é 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à 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 8 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	textstor.h
DLL	Msctf.dll

Voir aussi

ITextStoreACP2

Partager via