Метод ITfProperty::SetValueStore (msctf.h)

Статья
08/24/2023

Задает значение свойства для диапазона текста с помощью объекта хранилища свойств.

Синтаксис

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

Параметры

[in] ec

Содержит файл cookie редактирования, определяющий контекст редактирования. Он получен из ITfDocumentMgr::CreateContext или ITfEditSession::D oEditSession.

[in] pRange

Указатель на интерфейс ITfRange , содержащий диапазон, для котором задано значение свойства. Этот параметр не может иметь значение NULL. Этот метод завершается ошибкой, если pRange пуст.

[in] pPropStore

Указатель на интерфейс ITfPropertyStore , который получает данные свойства.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Значение	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	Один или несколько параметров являются недопустимыми.
E_FAIL	Произошла неизвестная ошибка.
TF_E_NOLOCK	Контекст редактирования, определяемый ec , не имеет блокировки чтения и записи.

Значения свойств, заданные с помощью ITfProperty::SetValue , будут удалены при изменении текста, охватывающего значение свойства. Чтобы получить контроль над тем, что происходит со значением свойства при изменении текста, используйте ITfProperty::SetValueStore .

Значения, заданные с помощью ITfProperty::SetValue , будут сериализованы, за исключением значений типа VT_UNKNOWN, которые не сериализуются. Если необходимо сериализовать значение свойства типа VT_UNKNOWN, используйте ITfProperty::SetValueStore .

Перекрывающиеся значения свойств одного типа не поддерживаются.

Требования


Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	msctf.h
DLL	Msctf.dll
Распространяемые компоненты	TSF 1.0 в Windows 2000 Профессиональная