InkOverlay.CollectingInk-Eigenschaft

Artikel
11/26/2008

Ruft einen Wert ab, der angibt, ob gerade Freihandeingaben auf einem InkOverlay-Objekt gezeichnet werden.

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

Syntax

'Declaration
<BrowsableAttribute(False)> _
Public ReadOnly Property CollectingInk As Boolean
'Usage
Dim instance As InkOverlay
Dim value As Boolean

value = instance.CollectingInk

[BrowsableAttribute(false)]
public bool CollectingInk { get; }

[BrowsableAttribute(false)]
public:
property bool CollectingInk {
    bool get ();
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public boolean get_CollectingInk()

public function get CollectingInk () : boolean

Eigenschaftenwert

Typ: System.Boolean
Ein Wert, der angibt, ob gerade Freihandeingaben auf einem InkOverlay-Objekt gezeichnet werden.
true , wenn Freihandeingaben gerade auf dem InkOverlay-Objekt gezeichnet werden, andernfalls false.

Hinweise

Sie können die CollectingInk-Eigenschaft verwenden, um zu sehen, ob auf einem InkOverlay-Objekt gerade Freihandeingaben gezeichnet werden, anstatt dafür das Stroke-Ereignis zu überwachen.

Hinweis

Da die Erfassung von Freihandeingaben in einem anderen Thread und nicht im Anwendungscode behandelt wird, kann der Wert der CollectingInk-Eigenschaft in true geändert werden, während der Anwendungscode unter der Annahme ausgeführt wird, dass der Wert immer noch false ist. Um diesen Fall zu behandeln, sollte Code, der vom Wert der CollectingInk-Eigenschaft abhängt, in einem try-catch-Block enthalten sein.

Beispiele

In diesem Beispiel werden alle Striche des InkOverlay-Objekts ausgewählt, indem die Selection-Eigenschaft auf dieselbe Strokes-Auflistung festgelegt wird, die vom zugeordneten Ink-Objekt verwendet wird.

Nach der Auswahl wird die EditingMode-Eigenschaft auf Select festgelegt.

Die EditingMode-Eigenschaft kann nicht geändert werden, während das Objekt Freihandeingaben erfasst. Da die Erfassung von Freihandeingaben in einem anderen Thread und nicht im Anwendungscode behandelt wird, kann der Wert der CollectingInk-Eigenschaft in true geändert werden, während der Anwendungscode unter der Annahme ausgeführt wird, dass der Wert immer noch false ist. Um diesen Fall zu behandeln, sollte der Zugriff auf die EditingMode-Eigenschaft in einem try-catch-Block enthalten sein.

' Select all strokes
' mInkObject can be InkOverlay or InkPicture
Try
    If Not mInkObject.CollectingInk Then
        mInkObject.Selection = mInkObject.Ink.Strokes
        mInkObject.EditingMode = InkOverlayEditingMode.Select
    End If

Catch
    ' handle or rethrow
End Try

// Select all strokes
// mInkObject can be InkOverlay or InkPicture
try
{
    if (!mInkObject.CollectingInk)
    {
        mInkObject.Selection = mInkObject.Ink.Strokes;
        mInkObject.EditingMode = InkOverlayEditingMode.Select;
    }
}
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.