Метод ITfEditRecord::GetTextAndPropertyUpdates (msctf.h)

Статья
08/24/2023

Получает перечислитель, содержащий коллекцию объектов диапазона, охватывающих указанные свойства и /или текст, измененный во время сеанса редактирования.

Синтаксис

HRESULT GetTextAndPropertyUpdates(
  [in]  DWORD         dwFlags,
  [in]  const GUID    **prgProperties,
  [in]  ULONG         cProperties,
  [out] IEnumTfRanges **ppEnum
);

Параметры

[in] dwFlags

Содержит сочетание следующих значений, задающих поведение этого метода.

Значение	Значение
0	Указывает, что метод получит коллекцию объектов диапазона, охватывающих указанные свойства, измененные во время сеанса редактирования. PrgProperties не может иметь значение NULL , а значение cProperties должно быть больше нуля.
TF_GTP_INCL_TEXT	Указывает, что метод получит коллекцию объектов диапазона, которые охватывают текст, измененный во время сеанса редактирования.

Значение

0

Указывает, что метод получит коллекцию объектов диапазона, охватывающих указанные свойства, измененные во время сеанса редактирования. PrgProperties не может иметь значение NULL , а значение cProperties должно быть больше нуля.

TF_GTP_INCL_TEXT

Указывает, что метод получит коллекцию объектов диапазона, которые охватывают текст, измененный во время сеанса редактирования.

[in] prgProperties

Указатель на массив значений GUID , определяющих свойства для поиска изменений. Этот метод выполняет поиск свойств, измененных во время сеанса редактирования, и, если свойство содержится в этом массиве, объект диапазона, охватывающий измененное свойство, добавляется в ppEnum.

Этот массив должен иметь по крайней мере размер элементов cProperties .

Этот параметр игнорируется, если dwFlags содержит TF_GTP_INCL_TEXT а cProperties равно нулю.

[in] cProperties

Указывает количество элементов в массиве prgProperties .

Этот параметр может быть равен нулю, если dwFlags содержит TF_GTP_INCL_TEXT. Это означает, что изменения свойств не получены.

[out] ppEnum

Указатель на указатель интерфейса IEnumTfRanges , который получает объект перечислителя.

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

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

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

Требования


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

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

IEnumTfRanges

ITfEditRecord

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