ITextStoreAnchor::RequestAttrsTransitioningAtPosition method (textstor.h)

Obtains a list of attributes that begin or end at the specified anchor location.

Syntax

HRESULT RequestAttrsTransitioningAtPosition(
  [in] IAnchor         *paPos,
  [in] ULONG           cFilterAttrs,
  [in] const TS_ATTRID *paFilterAttrs,
  [in] DWORD           dwFlags
);

Parameters

[in] paPos

Pointer to the anchor.

[in] cFilterAttrs

Specifies the number of attributes to obtain.

[in] paFilterAttrs

Pointer to the TS_ATTRID data type that specifies the attribute to verify.

[in] dwFlags

Specifies attributes for the call to the ITextStoreAnchor::RetrieveRequestedAttrs method. If this parameter is not set, the method returns the attributes that start at the specified anchor location. Other possible values for this parameter are the following.

Value Meaning
TS_ATTR_FIND_WANT_END
Obtains the attributes that end at the specified anchor location.
TS_ATTR_FIND_WANT_VALUE
Obtains the value of the attribute in addition to the attribute. The attribute value is put into the varValue member of the TS_ATTRVAL structure during the ITextStoreAnchor::RetrieveRequestedAttrs method call.

Return value

This method can return one of these values.

Value Description
S_OK
The method was successful.
E_INVALIDARG
paPos is invalid.

Remarks

In the sentence, "This is italic text.", the italic attribute starts before the word italic and ends after the word text.

If the flag TS_ATTR_FIND_WANT_END is set in dwFlags, the method would return the italic attribute for the text "italic <anchor>normal", because there is an end transition at the anchor location.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header textstor.h
DLL Msctf.dll
Redistributable TSF 1.0 on Windows 2000 Professional

See also

ITextStoreAnchor

ITextStoreAnchor::RetrieveRequestedAttrs

TS_ATTRID

TS_ATTRVAL

TS_ATTR_* Constants