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

Article
08/26/2023

La méthode ITextStoreACP::FindNextAttrTransition détermine la position du caractère 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]  LONG            acpStart,
  [in]  LONG            acpHalt,
  [in]  ULONG           cFilterAttrs,
  [in]  const TS_ATTRID *paFilterAttrs,
  [in]  DWORD           dwFlags,
  [out] LONG            *pacpNext,
  [out] BOOL            *pfFound,
  [out] LONG            *plFoundOffset
);

Paramètres

[in] acpStart

Spécifie la position des caractères pour démarrer la recherche d’une transition d’attribut.

[in] acpHalt

Spécifie la position de caractère pour mettre fin à la recherche d’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.

[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.
TS_ATTR_FIND_WANT_OFFSET	Le paramètre plFoundOffset reçoit le décalage de caractères de la transition d’attribut à partir d’acpStart.

[out] pacpNext

Reçoit la position de caractère suivante pour case activée pour une transition d’attribut.

[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 la position de caractère de la transition d’attribut (et non les positions ACP). Si TS_ATTR_FIND_WANT_OFFSET indicateur est défini dans dwFlags, reçoit le décalage de caractères de la transition d’attribut à partir d’acpStart.

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_INVALIDPOS	Les positions de caractères spécifiées sont au-delà du texte dans le document.

Remarques

Note Si une application n’implémente pas ITextStoreACP::FindNextAttrTransition, ITfReadOnlyProperty::EnumRanges échoue avec E_FAIL.

Configuration requise


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

TS_ATTRID

constantes TS_ATTR_*

Partager via