ITextStoreAnchor::FindNextAttrTransition method

The ITextStoreAnchor::FindNextAttrTransition method finds the location in the text stream where a transition occurs in an attribute value. The specified attribute to check is application-dependent.

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

Parameters

paStart [in]

Pointer to the anchor position at the start of a range to search for an attribute transition.

paHalt [in]

Pointer to the anchor position at the end of a range to search for an attribute transition.

cFilterAttrs [in]

Specifies the number of attributes to check.

paFilterAttrs [in]

Pointer to the TS_ATTRID data type that specifies the attribute to check. Pre-defined attributes are given in tsattrs.h.

dwFlags [in]

Specifies the direction to search for an attribute transition. By default, the method searches forward.

Value	Meaning
TS_ATTR_FIND_BACKWARDS	The method searches backward in the text stream.
TS_ATTR_FIND_UPDATESTART	The method positions the input anchor paStart at the next attribute transition, if one is found. Otherwise the input anchor is not modified.
TS_ATTR_FIND_WANT_OFFSET	The plFoundOffset parameter receives the character offset of the attribute transition from paStart.

 

pfFound [out]

Receives a Boolean value of TRUE if an attribute transition was found, otherwise FALSE is returned.

plFoundOffset [out]

Receives the character offset of the attribute transition from the start anchor paStart.

Return value

This method can return one of these values.

Requirements

See also

ITextStoreAnchor

TS_ATTRID

TS_ATTR_* Constants