ITextStoreACP::FindNextAttrTransition-Methode (textstor.h)

Artikel
08/26/2023

Die ITextStoreACP::FindNextAttrTransition-Methode bestimmt die Zeichenposition, an der ein Übergang in einem Attributwert erfolgt. Das 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, an 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 Parameter plFoundOffset empfängt den Zeichenoffset des Attributübergangs von acpStart.

[out] pacpNext

Empfängt die nächste Zeichenposition, um nach einem Attributübergang zu suchen.

[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 dem Text im Dokument.

Hinweise

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

Anforderungen


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

Weitere Informationen

Itextstoreacp

TS_ATTRID

TS_ATTR_*-Konstanten

Freigeben über