ITextStoreAnchor::FindNextAttrTransition-Methode (textstor.h)

Artikel
03/02/2024

Die ITextStoreAnchor::FindNextAttrTransition-Methode findet den Speicherort im Textstream, an dem ein Übergang in einem Attributwert stattfindet. Das angegebene zu überprüfende Attribut ist anwendungsabhängig.

Syntax

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
);

Parameter

[in] paStart

Zeiger auf die Ankerposition am Anfang eines Bereichs, um nach einem Attributübergang zu suchen.

[in] paHalt

Zeiger auf die Ankerposition am Ende eines Bereichs, um nach einem Attributübergang zu suchen.

[in] cFilterAttrs

Gibt die Anzahl der zu überprüfenden Attribute an.

[in] paFilterAttrs

Zeiger auf den TS_ATTRID Datentyp, der das zu überprüfende Attribut angibt. Vordefinierte Attribute werden in tsattrs.h angegeben.

[in] dwFlags

Gibt die Richtung an, in der nach einem Attributübergang gesucht werden soll. Standardmäßig sucht die Methode vorwärts.

Wert	Bedeutung
TS_ATTR_FIND_BACKWARDS	Die -Methode sucht rückwärts im Textstream.
TS_ATTR_FIND_UPDATESTART	Die -Methode positioniert den Eingabeanker paStart beim nächsten Attributübergang, sofern einer gefunden wird. Andernfalls wird der Eingabeanker nicht geändert.
TS_ATTR_FIND_WANT_OFFSET	Der plFoundOffset-Parameter empfängt den Zeichenoffset des Attributübergangs von paStart.

[out] pfFound

Empfängt den booleschen Wert TRUE , wenn ein Attributübergang gefunden wurde, andernfalls wird FALSE zurückgegeben.

[out] plFoundOffset

Empfängt den Zeichenoffset des Attributübergangs vom Startanker paStart.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_INVALIDARG	paStart und/oder paHalt sind ungültig.
TS_E_INVALIDPOS	Die angegebenen Zeichenpositionen liegen über den Text im Dokument hinaus.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	textstor.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

ITextStoreAnchor

TS_ATTRID

TS_ATTR_*-Konstanten

Freigeben über