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

Метод ITfReadOnlyProperty::GetValue (msctf.h)

  • Статья

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

Синтаксис

HRESULT GetValue(
  [in]  TfEditCookie ec,
  [in]  ITfRange     *pRange,
  [out] VARIANT      *pvarValue
);

Параметры

[in] ec

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

[in] pRange

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

[out] pvarValue

Указатель на значение VARIANT , которое получает значение свойства. Тип данных и содержимое этого значения определяются владельцем свойства и должны быть распознаны вызывающей стороны, чтобы использовать это значение. Вызывающий объект должен освободить эти данные, если они больше не требуются, передав это значение в API VariantClear .

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

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

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

Комментарии

Если свойство не имеет значения по сравнению с pRange, pRange содержит несколько значений свойства или свойство не полностью охватывает pRange, pvarValue получает значение VT_EMPTY, а метод возвращает S_FALSE.


COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range-->||<-



COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range-->|    |<-



COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range-->|             |<-

Требования

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

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

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

ITfReadOnlyProperty