Ink.ExtendedProperties (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene la colección de datos definidos por la aplicación.

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

Sintaxis

'Declaración
Public ReadOnly Property ExtendedProperties As ExtendedProperties
'Uso
Dim instance As Ink
Dim value As ExtendedProperties

value = instance.ExtendedProperties

public ExtendedProperties ExtendedProperties { get; }

public:
property ExtendedProperties^ ExtendedProperties {
    ExtendedProperties^ get ();
}

/** @property */
public ExtendedProperties get_ExtendedProperties()

public function get ExtendedProperties () : ExtendedProperties

Valor de propiedad

Tipo: Microsoft.Ink.ExtendedProperties
Colección de datos definidos por la aplicación.

Comentarios

Las aplicaciones pueden usar la propiedad ExtendedProperties para tener acceso a los datos personalizados que se almacenan en el objeto Ink. Estos datos personalizados se serializan automáticamente con el objeto.

Ejemplos

En este ejemplo se examina la propiedad Dirty. Si es true, el objeto Ink de un objeto InkOverlay se guarda en un archivo en el formato InkSerializedFormat (ISF) predeterminado. ExtendedProperty se agrega al objeto Ink para realizar un seguimiento de la hora en que se guardó la entrada manuscrita.

Try
    If mInkOverlay.Ink.Dirty Then
        ' TIME_GUID is a class level string set via GUID generator
        Dim timeGuid As Guid = New Guid(TIME_GUID)
        mInkOverlay.Ink.ExtendedProperties.Add(timeGuid, DateTime.Now)
        ' FILE_NAME is a class level const
        Using FS As FileStream = New FileStream(FILE_NAME, FileMode.Create)
            Dim isf As Byte() = mInkOverlay.Ink.Save()
            FS.Write(isf, 0, isf.Length)
        End Using
    End If
Catch
    ' handle or rethrow
End Try

try
{
    if (mInkOverlay.Ink.Dirty)
    {
        // TIME_GUID is a class level string set via GUID generator
        Guid timeGuid = new Guid(TIME_GUID);
        mInkOverlay.Ink.ExtendedProperties.Add(timeGuid, DateTime.Now);
        // FILE_NAME is a class level const
        using (FileStream FS = new FileStream(FILE_NAME, FileMode.Create))
        {
            byte[] isf = mInkOverlay.Ink.Save();
            FS.Write(isf, 0, isf.Length);
        }
    }
}
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.