Metodo Ink.Load

Articolo
10/29/2008

Aggiornamento: novembre 2007

Compila un nuovo oggetto Ink con i dati binari noti.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Sub Load ( _
    inkdata As Byte() _
)
'Utilizzo
Dim instance As Ink
Dim inkdata As Byte()

instance.Load(inkdata)

public void Load(
    byte[] inkdata
)

public:
void Load(
    array<unsigned char>^ inkdata
)

public void Load(
    byte[] inkdata
)

public function Load(
    inkdata : byte[]
)

Parametri

inkdata
Tipo: array<System.Byte[]
Matrice di byte che contiene i dati dell'input penna.

Note

È possibile caricare l'input penna solo in un oggetto Ink nuovo e vuoto: un oggetto Ink che non ha né raccolto nessun oggetto Stroke né è associato a proprietà. Se si tenta di caricare l'input penna in un oggetto Ink che ha raccolto tratti o è associato a proprietà, anche se i tratti o le proprietà sono state eliminate dall'oggetto Ink, viene generata un'eccezione. Ciò si verifica a causa della modalità di assegnazione delle proprietà Id. Un oggetto Stroke è assegnato a una proprietà Id univoca e questa proprietà Id non viene riutilizzata, anche se l'oggetto Stroke è stato eliminato da un oggetto Ink. Pertanto, se un oggetto Ink conteneva un oggetto Stroke con proprietà Id uguale a 1 ed è stato eliminato l'oggetto Stroke e sono stati caricati dati dell'input penna differenti in questo oggetto Ink, la proprietà Id di qualsiasi nuovo oggetto Stroke dovrebbe essere avviata con 2. Tenere traccia di ciò attraverso i numerosi oggetti Ink potrebbe causare errori e per questo non è consentito.

Nota

Se si tenta di caricare l'input penna in un oggetto Ink che non è vuoto, tutti i dati nell'oggetto Ink, compreso qualsiasi CustomStrokes o ExtendedProperties, viene perso quando si chiama il metodo Load.

Il metodo Save consente di salvare in modo permanente l'input penna in formato GIF che è costituito da una matrice di dati del byte. Il formato di persistenza di GIF viene specificato nel tipo di enumerazione PersistenceFormat. Dopo avere ottenuto la matrice di dati del byte, è possibile caricarla in un altro oggetto Ink. In questo modo è possibile caricare dati della matrice di byte compatibili con GIF in un altro oggetto Ink, in modo identico a come se fosse stato chiamato il metodo Save e ricevuta una matrice di byte che non fosse in formato GIF.

Nota

Non è possibile creare un'immagine, salvarla in modo permanente come matrice di byte e caricare quella matrice di byte in un altro oggetto Ink. Ciò è dovuto al fatto che, dopo avere caricato dati della matrice di byte come GIF, Microsoft® Windows® XP Tablet PC Edition non può controllare il formato di quei dati; pertanto, dopo avere salvato in modo permanente nuovamente l'immagine in una matrice di byte, non è possibile chiamare Load su quei dati.

Esempi

In questo esempio, l'input penna salvato è caricato da un file nell'oggetto Ink di un oggetto InkOverlay.

Try
    ' Ink.Load() must work on a new (unused) ink object. 
    ' Otherwise, an exception is raised.
    mInkOverlay.Enabled = False
    mInkOverlay.Ink = New Ink()
    mInkOverlay.Enabled = True
    ' FILE_NAME is a class level const
    Using FS As FileStream = New FileStream(FILE_NAME, FileMode.Open)
        ' read the bytes from the file
        Dim isf(FS.Length) As Byte
        FS.Read(isf, 0, FS.Length)
        ' and load the Ink object
        mInkOverlay.Ink.Load(isf)
    End Using
Catch
    ' handle or rethrow
End Try

try
{
    // Ink.Load() must work on a new (unused) ink object. 
    // Otherwise, an exception is raised.
    mInkOverlay.Enabled = false;
    mInkOverlay.Ink = new Ink();
    mInkOverlay.Enabled = true;
    // FILE_NAME is a class level const
    using (FileStream FS = new FileStream(FILE_NAME, FileMode.Open))
    {
        // read the bytes from the file
        byte[] isf = new byte[FS.Length];
        FS.Read(isf, 0, (int)FS.Length);
        // and load the Ink object
        mInkOverlay.Ink.Load(isf);
    }
}
catch 
{
    // handle or rethrow
}

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.