Metodo IInkDisp::Load (msinkaut.h)

Popola un nuovo oggetto InkDisp con dati binari noti.

Sintassi

HRESULT Load(
  [in] VARIANT Data
);

Parametri

[in] Data

Flusso che contiene i dati dell'input penna.

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_INVALIDARG	VARIANT non era di tipo corretto (matrice di byte).
E_OUTOFMEMORY	Impossibile allocare memoria per Stream.
E_UNEXPECTED	Parametro o tipo di proprietà imprevisto.
E_INK_EXCEPTION	Si è verificata un'eccezione all'interno del metodo .

Commenti

È possibile caricare l'input penna solo in un nuovo oggetto InkDisp vuoto, uno che non ha raccolto alcun tratto o non ha proprietà associate. Se si tenta di caricare l'input penna in un oggetto InkDisp che ha raccolto tratti o proprietà associate, anche se i tratti o le proprietà sono stati eliminati dall'oggetto InkDisp , viene generata un'eccezione. Ciò si verifica a causa della modalità di assegnazione degli ID tratto. A un tratto viene assegnato un ID univoco e questo ID non viene riutilizzato, anche se il tratto è stato eliminato da un oggetto Ink. Ciò significa che, se un oggetto InkDisp contiene un tratto con ID 1 ed è stato eliminato il tratto e caricato un altro oggetto InkDisp in questo oggetto InkDisp , gli ID tratti inizieranno a 2. Ciò potrebbe confondere e pertanto non è consentito.

Nota Se si tenta di caricare l'input penna in un oggetto InkDisp non vuoto, tutti i dati nell'oggetto InkDisp , inclusi i tratti personalizzati o le proprietà estese, vengono persi quando si chiama Load.

 

Il metodo Save consente di rendere persistente l'input penna in un oggetto InkDisp in formato GIF (Graphics Interchange Format), costituito da una matrice di dati byte (il formato di persistenza tla_gif è specificato nel tipo di enumerazione InkPersistenceFormat ). Dopo aver creato la matrice di dati dei byte, è possibile caricare la matrice di dati di byte in un altro oggetto InkDisp . Ciò significa che è possibile caricare dati di matrice di byte compatibili con GIF in un altro oggetto InkDisp nello stesso modo in cui si è chiamato il metodo Save e si è ricevuta una matrice di byte che non era in formato GIF.

Nota Non è possibile creare un'immagine, rendere persistente l'immagine come matrice di byte e quindi caricare tale matrice di byte in un altro oggetto InkDisp . Questo perché, dopo aver caricato i dati della matrice di byte come GIF, Tablet PC non può controllare il formato di tali dati. Quindi, dopo aver reso persistente l'immagine in una matrice di byte, non è possibile chiamare Carica su tali dati.

 

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

Metodo Save