Método ITextStoreACPServices::Serialize (msctf.h)

Obtém uma propriedade de um intervalo de texto e grava os dados da propriedade em um objeto de fluxo.

Sintaxe

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

Parâmetros

[in] pProp

Ponteiro para uma interface ITfProperty que identifica a propriedade a ser serializada.

[in] pRange

Ponteiro para uma interface ITfRange que identifica o intervalo do qual a propriedade é obtida.

[out] pHdr

Ponteiro para uma estrutura TF_PERSISTENT_PROPERTY_HEADER_ACP que recebe os dados de cabeçalho da propriedade.

[in] pStream

Ponteiro para um objeto IStream no qual o gerenciador do TSF gravará os dados da propriedade.

Retornar valor

Esse método pode retornar um desses valores.

Comentários

Os dados de cabeçalho de propriedade colocados em pHdr são genéricos para todas as propriedades e devem ser preservados com os dados gravados em pStream. Esse mesmo par de dados deve ser passado para ITextStoreACPServices::Unserialize para restaurar os dados da propriedade.

Um aplicativo pode salvar todas as propriedades de todo o documento executando as etapas a seguir.

• Enumerar todas as propriedades usando ITfContext::EnumProperties.
• Dentro de cada propriedade, enumere os intervalos usando ITfReadOnlyProperty::EnumRanges.
• Passe a propriedade e o intervalo atuais para ITextStoreACPServices::Serialize.
• Escreva os dados colocados em pHdr no arquivo.
• Escreva os dados adicionados ao pStream no arquivo.

Requisitos

Confira também

Interface ITextStoreACPServices, ITextStoreACPServices::Unserialize, ITfContext::EnumProperties, interface ITfProperty, interface ITfRange, ITfReadOnlyProperty::EnumRanges, TF_PERSISTENT_PROPERTY_HEADER_ACP estrutura