Compartilhar via

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

  • Artigo

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