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

Artículo
08/24/2023

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