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

Preenche um novo objeto InkDisp com dados binários conhecidos.

Sintaxe

HRESULT Load(
  [in] VARIANT Data
);

Parâmetros

[in] Data

O fluxo que contém os dados de tinta.

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_INVALIDARG	VARIANT não era do tipo correto (matriz de bytes).
E_OUTOFMEMORY	Não é possível alocar memória para Stream.
E_UNEXPECTED	Parâmetro inesperado ou tipo de propriedade.
E_INK_EXCEPTION	Ocorreu uma exceção dentro do método .

Comentários

Você pode carregar tinta somente em um novo objeto InkDisp vazio , um que não coletou nenhum traço ou não tem nenhuma propriedade anexada. Se você tentar carregar tinta em um objeto InkDisp que coletou traços ou propriedades anexadas, mesmo que os traços ou propriedades tenham sido excluídos do objeto InkDisp , uma exceção será gerada. Isso ocorre devido à forma como as IDs de traço são atribuídas. Um traço recebe uma ID exclusiva e essa ID não é reutilizado, mesmo que o traço tenha sido excluído de um objeto Ink. Isso significa que, se um objeto InkDisp contiver um traço com uma ID de 1 e você excluiu o traço e carregou outro objeto InkDisp neste objeto InkDisp , as IDs de traço começariam em 2. Isso seria confuso e, portanto, não é permitido.

Nota Se você tentar carregar tinta em um objeto InkDisp que não está vazio, todos os dados no objeto InkDisp , incluindo quaisquer traços personalizados ou propriedades estendidas, serão perdidos quando você chamar Load.

 

O método Save permite que você persista a tinta em um objeto InkDisp no formato GIF (Graphics Interchange Format), que consiste em uma matriz de dados de bytes (o formato de persistência tla_gif é especificado no tipo de enumeração InkPersistenceFormat ). Depois de ter a matriz de dados de bytes, você poderá carregar a matriz de dados de bytes em outro objeto InkDisp . Isso significa que você pode carregar dados de matriz de bytes compatíveis com GIF em outro objeto InkDisp da mesma forma que se tivesse chamado o método Save e recebido uma matriz de bytes que não estava no formato GIF.

Nota Você não pode criar uma imagem, persistir essa imagem como uma matriz de bytes e carregar essa matriz de bytes em outro objeto InkDisp . Isso ocorre porque, depois de carregar dados de matriz de bytes como um GIF, o Tablet PC não pode controlar o formato desses dados. Portanto, depois de persistir a imagem em uma matriz de bytes novamente, você não poderá chamar Load nesses dados.

 

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

Método Save