Compartilhar via


Método IInkDisp::Save (msinkaut.h)

Converte a tinta no InkPersistenceFormat especificado, salva a tinta usando o InkPersistenceCompressionMode especificado e retorna os dados binários em uma matriz de bytes.

Sintaxe

HRESULT Save(
  [in, optional] InkPersistenceFormat          PersistenceFormat,
  [in, optional] InkPersistenceCompressionMode CompressionMode,
  [out, retval]  VARIANT                       *Data
);

Parâmetros

[in, optional] PersistenceFormat

Opcional. Define um dos valores InkPersistenceFormat que indica o formato da tinta persistente. O valor padrão é InkSerializedFormat.

Nome Descrição
InkSerializedFormat
A tinta é mantida usando o ISF (formato serializado à tinta).

Essa é a representação mais compacta e persistente de tinta. Ela pode ser inserida em um formato de documento binário ou colocada diretamente na Área de Transferência. Esse é o valor padrão.

Base64InkSerializedFormat
A tinta é persistida codificando o ISF como um fluxo base64.

Esse formato é fornecido para que a tinta possa ser codificada diretamente em um arquivo XML (Extensible Markup Language) ou HTML.

Gif
A tinta é persistida usando um arquivo GIF (Graphics Interchange Format) que contém ISF como metadados inseridos no arquivo.

Isso permite que a tinta seja exibida em aplicativos que não estão habilitados para tinta e mantenham sua fidelidade total à tinta quando ela retorna a um aplicativo habilitado para tinta. Esse formato é ideal ao transportar conteúdo de tinta em um arquivo HTML e torná-lo utilizável por aplicativos habilitados para tinta e sem tinta.

Base64Gif
A tinta é persistida usando um fortificado codificado em base64.

Esse GIFformat é fornecido quando a tinta deve ser codificada diretamente em um arquivo XML ou HTML com conversão posterior em uma imagem. Um possível uso disso seria em um formato XML que é gerado para conter todas as informações de tinta e usado como uma maneira de gerar HTML por meio de XSLT (Extensible Stylesheet Language Transformations).

[in, optional] CompressionMode

Opcional. Um dos valores InkPersistenceCompressionMode que especifica o modo de compactação da tinta persistente. O valor padrão é IPCM_Default.

Nome Descrição
IPCM_Default
É usado quando a melhor compensação entre o tempo de salvamento e o armazenamento para o aplicativo típico é necessária.
IPCM_MaximumCompression
É usado quando minimizar o espaço de armazenamento é mais importante do que a rapidez com que a tinta é salva.
IPCM_NoCompression
É usado quando o tempo de salvamento é mais importante do que a quantidade de espaço de armazenamento usado e quando a compatibilidade entre as versões é importante.

[out, retval] Data

Quando este método retorna, contém a matriz de bytes que contém a tinta persistente.

Para obter mais informações sobre a estrutura VARIANT, consulte Usando a biblioteca COM.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
E_POINTER
Um parâmetro continha um ponteiro inválido.
E_INK_EXCEPTION
Ocorreu uma exceção dentro do método .
E_INVALIDARG
Modo de compactação inválido.
E_OUTOFMEMORY
Não é possível alocar a matriz de bytes.
E_UNEXPECTED
Ocorrerá se você tentar salvar um objeto Ink vazio no formato GIF.

Comentários

Tentar salvar um objeto InkDisp vazio no formato GIF gera um erro.

Nota Ao chamar o método Save com um valor InkPersistenceFormat de Base64InkSerializedFormat, o valor retornado é uma matriz de bytes terminada em NULL . Para gravar a tinta salva em um arquivo XML, primeiro remova o último byte da matriz antes de converter a matriz em uma cadeia de caracteres codificada em UTF-8 (Formato de Transformação Unicode) de 8 bits.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho msinkaut.h
Biblioteca InkObj.dll

Confira também

Iinkdisp

Classe InkDisp

Enumeração InkPersistenceCompressionMode

Enumeração InkPersistenceFormat

Método Load