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

Метод ITfContextOwnerServices::Serialize получает свойство из диапазона текста и записывает данные свойства в объект потока. Это позволяет приложению хранить данные свойств, например при записи данных в файл.

Синтаксис

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. Эту же пару данных необходимо передать в ITfContextOwnerServices::Unserialize для восстановления данных свойства.

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

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

Требования

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

ITfContextOwnerServices

ITfProperty

ITfRange

TF_PERSISTENT_PROPERTY_HEADER_ACP