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

  • Artículo

Convierte la entrada de lápiz en el inkPersistenceFormat especificado, guarda la entrada de lápiz mediante el inkPersistenceCompressionMode especificado y devuelve los datos binarios en una matriz de bytes.

Sintaxis

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

Parámetros

[in, optional] PersistenceFormat

Opcional. Establece uno de los valores InkPersistenceFormat que indica el formato de la entrada de lápiz persistente. El valor predeterminado es InkSerializedFormat.

Nombre Descripción
InkSerializedFormat
 La entrada de lápiz se conserva mediante el formato serializado de entrada de lápiz (ISF).

Este formato es la representación más compacta y persistente de la entrada de lápiz. Puede incrustarse en un formato de documento binario o colocarse directamente en el Portapapeles. Este es el valor predeterminado.
Base64InkSerializedFormat
 La entrada de lápiz se conserva codificando el ISF como una secuencia base64.

Este formato se proporciona para que la entrada de lápiz se pueda codificar directamente en un archivo XML (Lenguaje de marcado extensible) o HTML.
Gif
 La entrada de lápiz se conserva mediante un archivo de formato de intercambio de gráficos (GIF) que contiene ISF como metadatos incrustados en el archivo.

Esto permite ver la entrada de lápiz en aplicaciones que no están habilitadas para entrada de lápiz y mantener su fidelidad de entrada de lápiz completa cuando vuelve a una aplicación habilitada para entrada de lápiz. Este formato es ideal al transportar contenido de entrada de lápiz dentro de un archivo HTML y hacer que se pueda usar mediante aplicaciones habilitadas para entrada de lápiz y sin reconocimiento de entrada de lápiz.
Base64Gif
 La entrada de lápiz se conserva mediante una codificación base64.

Este GIFformat se proporciona cuando la entrada de lápiz se codifica directamente en un archivo XML o HTML con conversión posterior en una imagen. Un posible uso de esto sería en un formato XML que se genera para contener toda la información de entrada de lápiz y se usa como una manera de generar HTML a través de transformaciones de lenguaje de hoja de estilos extensibles (XSLT).

[in, optional] CompressionMode

Opcional. Uno de los valores InkPersistenceCompressionMode que especifica el modo de compresión de la entrada de lápiz persistente. El valor predeterminado es IPCM_Default.

Nombre Descripción
IPCM_Default
 Se usa cuando se necesita el mejor equilibrio entre ahorrar tiempo y almacenamiento para la aplicación típica.
IPCM_MaximumCompression
 Se usa al minimizar el espacio de almacenamiento es más importante que la rapidez con la que se guarda la entrada de lápiz.
IPCM_NoCompression
 Se usa cuando el tiempo de ahorro es más importante que la cantidad de espacio de almacenamiento utilizado y cuando la compatibilidad entre versiones es importante.

[out, retval] Data

Cuando este método vuelve, contiene la matriz de bytes que contiene la entrada de lápiz persistente.

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_POINTER
 Un parámetro contenía un puntero no válido.
E_INK_EXCEPTION
 Se produjo una excepción dentro del método .
E_INVALIDARG
 Modo de compresión no válido.
E_OUTOFMEMORY
 No se puede asignar la matriz de bytes.
E_UNEXPECTED
 Se produce si intenta guardar un objeto Ink vacío en formato GIF.

Comentarios

Si se intenta guardar un objeto InkDisp vacío en formato GIF, se genera un error.

Nota Al llamar al método Save con un valor InkPersistenceFormat de Base64InkSerializedFormat, el valor devuelto es una matriz de bytes terminada en NULL . Para escribir la entrada de lápiz guardada en un archivo XML, quite primero el último byte de la matriz antes de convertir la matriz en formato de transformación Unicode de 8 bits (UTF-8).
 

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

InkPersistenceCompressionMode (enumeración)

InkPersistenceFormat (enumeración)

Load (método)