ITextStoreACP2::FindNextAttrTransition-Methode (textstor.h)

Artikel
08/26/2023

Bestimmt die Zeichenposition, an der ein Übergang in einem Attributwert stattfindet. Das angegebene zu überprüfende Attribut ist anwendungsabhängig.

Syntax

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

Parameter

[in] acpStart

Gibt die Zeichenposition an, in der die Suche nach einem Attributübergang gestartet werden soll.

[in] acpHalt

Gibt die Zeichenposition an, um die Suche nach einem Attributübergang zu beenden.

[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.

[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.
TS_ATTR_FIND_WANT_OFFSET	Der plFoundOffset-Parameter empfängt den Zeichenoffset des Attributübergangs von acpStart.

[out] pacpNext

Empfängt die nächste Zeichenposition, die auf einen Attributübergang überprüft werden soll.

[out] pfFound

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

[out] plFoundOffset

Empfängt die Zeichenposition des Attributübergangs (keine ACP-Positionen). Wenn TS_ATTR_FIND_WANT_OFFSET Flag in dwFlags festgelegt ist, empfängt den Zeichenoffset des Attributübergangs von acpStart.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
TS_E_INVALIDPOS	Die angegebenen Zeichenpositionen liegen über den Text im Dokument hinaus.

Hinweise

Hinweis Wenn eine Anwendung FindNextAttrTransition nicht implementiert, schlägt ITfReadOnlyProperty::EnumRanges mit E_FAIL fehl.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	textstor.h
DLL	Msctf.dll

Weitere Informationen

ITextStoreACP2

TS_ATTRID

TS_ATTR_*-Konstanten

Freigeben über