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.

ITfProperty::SetValueStore method

Syntax


HRESULT SetValueStore(
  [in] TfEditCookie     ec,
  [in] ITfRange         *pRange,
  [in] ITfPropertyStore *pPropStore
);

Parameters

ec [in]

Contains an edit cookie that identifies the edit context. This is obtained from ITfDocumentMgr::CreateContext or ITfEditSession::DoEditSession.

pRange [in]

Pointer to an ITfRange interface that contains the range that the property value is set for. This parameter cannot be NULL. This method fails if pRange is empty.

pPropStore [in]

Pointer to an ITfPropertyStore interface that obtains the property data.

Return value

This method can return one of these values.

ValueDescription
S_OK

The method was successful.

E_INVALIDARG

One or more parameters are invalid.

E_FAIL

An unspecified error occurred.

TF_E_NOLOCK

The edit context identified by ec does not have a read/write lock.

 

Remarks

Property values set with ITfProperty::SetValue will be discarded when the text that the property value covers is modified. To gain control over what happens to a property value when the text is modified, use ITfProperty::SetValueStore .

Values set with ITfProperty::SetValue will be serialized, except for values of type VT_UNKNOWN, which are not serialized. If a property value of type VT_UNKNOWN must be serialized, use ITfProperty::SetValueStore instead.

Overlapping property values of the same type are unsupported.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Redistributable

TSF 1.0 on Windows 2000 Professional

Header

Msctf.h

IDL

Msctf.idl

DLL

Msctf.dll

See also

ITfProperty
ITfDocumentMgr::CreateContext
ITfEditSession::DoEditSession
ITfProperty::SetValue
ITfPropertyStore
ITfRange

 

 

Show:
© 2017 Microsoft