Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ITextStoreACP2::RequestAttrsAtPosition method

Gets text attributes at the specified character position.

Syntax


HRESULT RequestAttrsAtPosition(
  [in]                                      LONG      acpPos,
  [in]                                      ULONG     cFilterAttrs,
  [in, size_is(cFilterAttrs), unique] const TS_ATTRID *paFilterAttrs,
  [in]                                      DWORD     dwFlags
);

Parameters

acpPos [in]

Specifies the application character position in the document.

cFilterAttrs [in]

Specifies the number of attributes to obtain.

paFilterAttrs [in]

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

dwFlags [in]

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

ValueMeaning
TS_ATTR_FIND_WANT_END

Obtains the attributes that end at the specified application character position.

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 RetrieveRequestedAttrs method call.

 

Return value

This method can return one of these values.

ValueDescription
S_OK

The method was successful.

 

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

Minimum supported client

Windows 8 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 [desktop apps | Windows Store apps]

Header

Textstor.h

IDL

Textstor.idl

DLL

Msctf.dll

See also

ITextStoreACP2
RetrieveRequestedAttrs
TS_ATTRID
TS_ATTR_* Constants
TS_ATTRVAL

 

 

Show:
© 2017 Microsoft