Ink.Load (Método)

Artículo
11/26/2008

Actualización: noviembre 2007

Rellena un nuevo objeto Ink con datos binarios conocidos.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Sub Load ( _
    inkdata As Byte() _
)
'Uso
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[]
)

Parámetros

inkdata
Tipo: array<System.Byte[]
Matriz de bytes que contiene los datos de la entrada manuscrita.

Comentarios

La entrada manuscrita solamente se puede cargar en un objeto Ink vacío, es decir, un objeto Ink que no haya recopilado ningún objeto Stroke ni tenga ninguna propiedad asociada. Si intenta cargar la entrada manuscrita en un objeto Ink que tiene trazos recopilado o propiedades asociadas, se produce una excepción incluso si los trazos o las propiedades se han eliminado del objeto Ink. Esto ocurre por el modo en que están asignadas las propiedades Id. Un objeto Stroke tiene asignada una propiedad Id única y esta propiedad no se reutiliza Id, ni siquiera si el objeto Stroke se ha eliminado de un objeto Ink. Esto significa que si un objeto Ink incluido en Stroke con una propiedad Id de 1, se ha eliminado Stroke y se han cargado datos de entrada manuscrita diferentes en este objeto Ink, la propiedad Id de cualquier objeto Stroke nuevo tendrá que iniciarse en 2. Si se hace el seguimiento de esto en numerosos objetos Ink puede conducir a errores y por tanto no se permite.

Nota

Si intenta cargar entradas manuscritas en un objeto Ink que no está vacío, al llamar al método Load todos los datos del objeto Ink se perderán, incluidos CustomStrokes y ExtendedProperties.

El método Save permite conservar la entrada manuscrita en formato GIF, que está compuesto por una matriz de datos byte. El formato de persistencia GIF se especifica en el tipo de enumeración PersistenceFormat. Después de tener la matriz de datos byte, puede cargarla en otro objeto Ink. Esto significa que puede cargar los datos de la matriz de bytes compatibles con GIF en otro objeto Ink de la misma manera que si hubiese llamado el método Save y hubiese recibido una matriz de bytes que no estuviese en formato GIF.

Nota

No puede crear una imagen, conserve esa imagen como una matriz de bytes y, a continuación, cargue esa matriz de bytes en otro objeto Ink. Esto ocurre porque después de cargar los datos de la matriz de bytes como un GIF, Microsoft® Windows® XP Tablet PC Edition no puede controlar el formato de esos datos; por consiguiente, después de conservar la imagen otra vez en una matriz de bytes, no puede llamar Load en esos datos.

Ejemplos

En este ejemplo, la entrada manuscrita guardada se carga de un archivo en el objeto Ink de un objeto 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
}

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.