Méthode ITextStoreAnchor ::FindNextAttrTransition (textstor.h)

Article
03/04/2024

La méthode ITextStoreAnchor ::FindNextAttrTransition recherche l’emplacement dans le flux de texte où une transition se produit dans une valeur d’attribut. L’attribut spécifié à case activée dépend de l’application.

Syntaxe

HRESULT FindNextAttrTransition(
  [in]  IAnchor         *paStart,
  [in]  IAnchor         *paHalt,
  [in]  ULONG           cFilterAttrs,
  [in]  const TS_ATTRID *paFilterAttrs,
  [in]  DWORD           dwFlags,
  [out] BOOL            *pfFound,
  [out] LONG            *plFoundOffset
);

Paramètres

[in] paStart

Pointeur vers la position d’ancre au début d’une plage pour rechercher une transition d’attribut.

[in] paHalt

Pointeur vers la position d’ancre à la fin d’une plage pour rechercher une transition d’attribut.

[in] cFilterAttrs

Spécifie le nombre d’attributs à case activée.

[in] paFilterAttrs

Pointeur vers le type de données TS_ATTRID qui spécifie l’attribut à case activée. Les attributs prédéfinis sont donnés dans tsattrs.h.

[in] dwFlags

Spécifie la direction de la recherche d’une transition d’attribut. Par défaut, la méthode effectue une recherche vers l’avant.

Valeur	Signification
TS_ATTR_FIND_BACKWARDS	La méthode effectue des recherches vers l’arrière dans le flux de texte.
TS_ATTR_FIND_UPDATESTART	La méthode positionne l’ancre d’entrée paStart lors de la transition d’attribut suivante, le cas échéant. Sinon, l’ancre d’entrée n’est pas modifiée.
TS_ATTR_FIND_WANT_OFFSET	Le paramètre plFoundOffset reçoit le décalage de caractères de la transition d’attribut à partir de paStart.

[out] pfFound

Reçoit une valeur booléenne TRUE si une transition d’attribut a été trouvée, sinon FALSE est retourné.

[out] plFoundOffset

Reçoit le décalage de caractères de la transition d’attribut à partir du paStart d’ancre de début.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Description
S_OK	La méthode a réussi.
E_INVALIDARG	paStart et/ou paHalt ne sont pas valides.
TS_E_INVALIDPOS	Les positions de caractères spécifiées sont au-delà du texte dans le document.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	textstor.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

ITextStoreAnchor

TS_ATTRID

constantes TS_ATTR_*

Partager via