Поделиться через

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

  • Статья

Задает значение свойства для диапазона.

Синтаксис

HRESULT SetValue(
  [in] TfEditCookie  ec,
  [in] ITfRange      *pRange,
  [in] const VARIANT *pvarValue
);

Параметры

[in] ec

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

[in] pRange

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

[in] pvarValue

Указатель на структуру VARIANT , содержащую новое значение свойства. Поддерживаются только значения типа VT_I4, VT_UNKNOWN, VT_BSTR и VT_EMPTY.

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

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

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

Комментарии

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

Значения, заданные с помощью этого метода, сериализуются, за исключением значений типа 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 Профессиональная

См. также раздел

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfProperty

ITfProperty::SetValueStore

ITfRange