Метод 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 записывает данные свойства.

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

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

Комментарии

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

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

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

Требования

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

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