Ink.Load, méthode

Article
11/05/2008

Mise à jour : November 2007

Remplit un nouvel objet Ink avec les données binaires spécifiées.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Sub Load ( _
    inkdata As Byte() _
)
'Utilisation
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[]
)

Paramètres

inkdata
Type : array<System.Byte[]
Tableau d'octets qui contient les données d'entrée manuscrite.

Notes

Vous pouvez charger l'entrée manuscrite uniquement dans un objet Ink nouveau et vide (un objet Ink qui n'a pas collecté d'objet Stroke et qui n'a pas de propriétés attachées). Si vous essayez de charger l'entrée manuscrite dans un objet Ink qui a des traits collectés ou des propriétés attachées, une exception est levée, même si les traits ou les propriétés ont été supprimés de l'objet Ink. Ceci est dû à la façon dont les propriétés Id sont affectées. Une propriété Id unique est affectée à un objet Stroke, et cette propriété Id n'est pas réutilisée, même si l'objet Stroke a été supprimé d'un objet Ink. Ceci signifie que si un objet Ink contenait un Stroke avec une propriété Id égale à 1 et que vous avez supprimé le Stroke et chargé différentes données d'entrée manuscrite dans cet objet Ink, la propriété Id de tout nouvel objet Stroke devra démarrer à 2. Effectuer le suivi de plusieurs objets Ink de cette manière pourrait générer des erreurs ; c'est la raison pour laquelle ceci n'est pas autorisé.

Remarque :
Si vous essayez de charger l'entrée manuscrite dans un objet Ink qui n'est pas vide, toutes les données de l'objet Ink, y compris un CustomStrokes ou un ExtendedProperties, sont perdues lorsque vous appelez la méthode Load.

La méthode Save vous permet de rendre l'entrée manuscrite persistante au format GIF, ce qui constitue un tableau de données en octets. Le format de persistance GIF est spécifié dans le type énumération PersistenceFormat. Après avoir obtenu le tableau de données en octets, vous pouvez le charger dans un autre objet Ink. Cela signifie que vous pouvez charger des données du tableau d'octets compatibles avec le format GIF dans un autre objet Ink comme si vous aviez appelé la méthode Save et que vous aviez obtenu un tableau d'octets qui n'était pas au format GIF.

Remarque :
Vous ne pouvez ni créer une image, ni la rendre persistante sous forme d'un tableau d'octets, ni charger ce tableau d'octets dans un autre objet Ink. L'explication est la suivante : après avoir chargé des données de tableau d'octets au format GIF, Microsoft® Windows® XP Édition Tablet PC ne peut plus contrôler le format de ces données ; donc, après avoir à nouveau rendu l'image persistante en un tableau d'octets, vous ne pouvez pas appeler la méthode Load sur ces données.

Vous ne pouvez ni créer une image, ni la rendre persistante sous forme d'un tableau d'octets, ni charger ce tableau d'octets dans un autre objet Ink. L'explication est la suivante : après avoir chargé des données de tableau d'octets au format GIF, Microsoft® Windows® XP Édition Tablet PC ne peut plus contrôler le format de ces données ; donc, après avoir à nouveau rendu l'image persistante en un tableau d'octets, vous ne pouvez pas appeler la méthode Load sur ces données.

Exemples

Dans cet exemple, l'entrée manuscrite enregistrée est chargée à partir d'un fichier dans l'objet Ink d'un objet 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
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.