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

Метод ITextStoreACPServices::Serialize (msctf.h)

  • Статья

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

Синтаксис

HRESULT Serialize(
  [in]  ITfProperty                       *pProp,
  [in]  ITfRange                          *pRange,
  [out] TF_PERSISTENT_PROPERTY_HEADER_ACP *pHdr,
  [in]  IStream                           *pStream
);

Параметры

[in] pProp

Указатель на интерфейс ITfProperty , который идентифицирует свойство для сериализации.

[in] pRange

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

[out] pHdr

Указатель на структуру TF_PERSISTENT_PROPERTY_HEADER_ACP , которая получает данные заголовка для свойства .

[in] pStream

Указатель на объект IStream , в который диспетчер TSF записывает данные свойства.

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

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

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

Комментарии

Данные заголовка свойства, помещенные в pHDR , являются универсальными для всех свойств и должны сохраняться вместе с данными, записанными в pStream. Эта же пара данных должна быть передана в ITextStoreACPServices::Unserialize для восстановления данных свойства.

Приложение может сохранить все свойства для всего документа, выполнив следующие действия.

  • Перечисление всех свойств с помощью ITfContext::EnumProperties.
  • В каждом свойстве перечислите диапазоны с помощью ITfReadOnlyProperty::EnumRanges.
  • Передайте текущее свойство и диапазон в ITextStoreACPServices::Serialize.
  • Запишите данные, размещенные в pHDR , в файл.
  • Запишите данные, добавленные в pStream , в файл.
При вызове этого метода приложение должно иметь возможность предоставить синхронную блокировку только для чтения.

Требования

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

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

Интерфейс ITextStoreACPServices, ITextStoreACPServices::Unserialize, ITfContext::EnumProperties, интерфейс ITfProperty, интерфейс ITfRange, ITfReadOnlyProperty::EnumRanges, TF_PERSISTENT_PROPERTY_HEADER_ACP структура