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

Rellena un nuevo objeto InkDisp con datos binarios conocidos.

Sintaxis

HRESULT Load(
  [in] VARIANT Data
);

Parámetros

[in] Data

Secuencia que contiene los datos de entrada de lápiz.

Para obtener más información sobre la estructura VARIANT, vea Uso de la biblioteca COM.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	Correcto.
E_INVALIDARG	VARIANT no era de tipo correcto (matriz de bytes).
E_OUTOFMEMORY	No se puede asignar memoria para Stream.
E_UNEXPECTED	Tipo de propiedad o parámetro inesperado.
E_INK_EXCEPTION	Se produjo una excepción dentro del método .

Comentarios

Solo puede cargar la entrada de lápiz en un nuevo objeto InkDisp vacío: uno que no ha recopilado ningún trazo o no tiene propiedades adjuntas. Si intenta cargar la entrada de lápiz en un objeto InkDisp que ha recopilado trazos o propiedades adjuntas, incluso si se han eliminado los trazos o propiedades del objeto InkDisp , se produce una excepción. Esto ocurre debido a cómo se asignan los identificadores de trazo. A un trazo se le asigna un identificador único y este identificador no se reutiliza, incluso si el trazo se ha eliminado de un objeto Ink. Esto significa que, si un objeto InkDisp contenía un trazo con un identificador de 1 y eliminó el trazo y cargó otro objeto InkDisp en este objeto InkDisp , los identificadores de trazo comenzarían en 2. Esto sería confuso y, por lo tanto, no se permite.

Nota Si intenta cargar la entrada de lápiz en un objeto InkDisp que no está vacío, todos los datos del objeto InkDisp , incluidos los trazos personalizados o las propiedades extendidas, se pierden al llamar a Load.

 

El método Save permite conservar la entrada de lápiz en un objeto InkDisp en formato de intercambio de gráficos (GIF), que consta de una matriz de datos de bytes (el formato de persistencia tla_gif se especifica en el tipo de enumeración InkPersistenceFormat ). Después de tener la matriz de datos de bytes, puede cargar la matriz de datos de bytes en otro objeto InkDisp . Esto significa que puede cargar datos de matriz de bytes compatibles con GIF en otro objeto InkDisp de la misma manera que si hubiera llamado al método Save y recibiera una matriz de bytes que no estaba en formato GIF.

Nota No se puede crear una imagen, conservar esa imagen como una matriz de bytes y, a continuación, cargar esa matriz de bytes en otro objeto InkDisp . Esto se debe a que, después de cargar los datos de la matriz de bytes como GIF, tablet PC no puede controlar el formato de esos datos. Por lo tanto, después de conservar la imagen en una matriz de bytes de nuevo, no puede llamar a Load en esos datos.

 

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	msinkaut.h
Library	InkObj.dll

Consulte también

IInkDisp

Clase InkDisp

Save (método)