Ink.Dirty-Eigenschaft

Artikel
11/26/2008

Ruft den Wert ab oder legt den Wert fest, der angibt, ob ein Ink-Objekt seit der letzter Speicherung der Freihandeingaben geändert wurde.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Property Dirty As Boolean
'Usage
Dim instance As Ink
Dim value As Boolean

value = instance.Dirty

instance.Dirty = value

public bool Dirty { get; set; }

public:
property bool Dirty {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_Dirty()
/** @property */
public  void set_Dirty(boolean value)

public function get Dirty () : boolean
public function set Dirty (value : boolean)

Eigenschaftenwert

Typ: System.Boolean
true , wenn das Ink-Objekt geändert wurde, seit das Ink-Objekt zum letzten Mal gespeichert wurde; andernfalls false.

Hinweise

Nachdem die Freihandeingaben gespeichert wurde, wird die Dirty-Eigenschaft automatisch gelöscht, und der Wert dieser Eigenschaft wird auf false festgelegt. Rufen Sie zum Speichern eines Ink-Objekts die Save-Methode auf.

Beispiele

In diesem Beispiel wird die Dirty-Eigenschaft überprüft. Beim Wert true wird das Ink-Objekt eines InkOverlay-Objekts in einer Datei im standardmäßigen InkSerializedFormat (ISF) gespeichert. Eine ExtendedProperty wird dem Ink-Objekt hinzugefügt, um den Speicherzeitpunkt der Freihandeingabe zu verfolgen.

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
}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.