Condividi tramite


Metodo IInkDisp::Save (msinkaut.h)

Converte l'input penna nell'input penna specificato InkPersistenceFormat, salva l'input penna usando l'input penna specificato InkPersistenceCompressionMode e restituisce i dati binari in una matrice di byte.

Sintassi

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

Parametri

[in, optional] PersistenceFormat

Facoltativo. Imposta uno dei valori InkPersistenceFormat che indica il formato dell'input penna persistente. Il valore predefinito è InkSerializedFormat.

Nome Descrizione
InkSerializedFormat
L'input penna viene mantenuto usando il formato serializzato dell'input penna (ISF).

Costituisce la rappresentazione persistente più compatta dell'input penna. Può essere incorporato in un formato di documento binario o inserito direttamente negli Appunti. Si tratta del valore predefinito.

Base64InkSerializedFormat
L'input penna viene mantenuto codificando l'ISF come flusso base64.

Questo formato viene fornito in modo che l'input penna possa essere codificato direttamente in un file XML (Extensible Markup Language) o HTML.

Gif
L'input penna viene mantenuto usando un file GIF (Graphics Interchange Format) che contiene ISF come metadati incorporati all'interno del file.

Ciò consente di visualizzare l'input penna nelle applicazioni non abilitate per l'input penna e mantenere la fedeltà dell'input penna completa quando restituisce un'applicazione abilitata per l'input penna. Questo formato è ideale quando si trasporta contenuto penna all'interno di un file HTML e rendendolo utilizzabile dalle applicazioni ink abilitate e ink-unware.

Base64Gif
L'input penna viene mantenuto usando una base64 codificata.

Questo formato GIF viene fornito quando l'input penna deve essere codificato direttamente in un file XML o HTML con una conversione successiva in un'immagine. Un possibile uso di questo tipo è in un formato XML generato per contenere tutte le informazioni sull'input penna e usato come modo per generare HTML tramite trasformazioni XSLT (Extensible Stylesheet Language Transformations).

[in, optional] CompressionMode

facoltativo. Uno dei valori InkPersistenceCompressionMode che specifica la modalità di compressione dell'input penna persistente. Il valore predefinito è IPCM_Default.

Nome Descrizione
IPCM_Default
Viene usato quando è necessario il compromesso migliore tra il tempo di salvataggio e l'archiviazione per l'applicazione tipica.
IPCM_MaximumCompression
Viene usato quando si riduce al minimo lo spazio di archiviazione è più importante del modo in cui viene salvato l'input penna.
IPCM_NoCompression
Viene usato quando il tempo di risparmio è più importante della quantità di spazio di archiviazione usato e quando la compatibilità tra le versioni è importante.

[out, retval] Data

Quando questo metodo restituisce, contiene la matrice di byte che contiene l'input penna persistente.

Per altre informazioni sulla struttura VARIANT, vedere Uso della libreria COM.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
Operazione completata.
E_POINTER
Un parametro contiene un puntatore non valido.
E_INK_EXCEPTION
Si è verificata un'eccezione all'interno del metodo.
E_INVALIDARG
Modalità di compressione non valida.
E_OUTOFMEMORY
Impossibile allocare matrice di byte.
E_UNEXPECTED
Si verifica se si tenta di salvare un oggetto Ink vuoto in formato GIF.

Commenti

Il tentativo di salvare un oggetto InkDisp vuoto in formato GIF genera un errore.

Nota Quando si chiama il metodo Save con un valore InkPersistenceFormat di Base64InkSerializedFormat, il valore restituito è una matrice di byte con terminazione NULL . Per scrivere l'input penna salvato in un file XML, rimuovere prima l'ultimo byte dalla matrice prima di convertire la matrice in formato di trasformazione Unicode a 8 bit (UTF-8) codificata stringa.
 

Requisiti

Requisito Valore
Client minimo supportato Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato Nessuno supportato
Piattaforma di destinazione Windows
Intestazione msinkaut.h
Libreria InkObj.dll

Vedi anche

IInkDisp

Classe InkDisp

Enumerazione InkPersistenceCompressionMode

Enumerazione InkPersistenceFormat

Metodo Load