InkCollector.CollectingInk-Eigenschaft

Artikel
11/26/2008

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

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

Syntax

'Declaration
Public ReadOnly Property CollectingInk As Boolean
'Usage
Dim instance As InkCollector
Dim value As Boolean

value = instance.CollectingInk

public bool CollectingInk { get; }

public:
property bool CollectingInk {
    bool get ();
}

/** @property */
public boolean get_CollectingInk()

public function get CollectingInk () : boolean

Eigenschaftenwert

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

Hinweise

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

Hinweis

Da die Freihanderfassung 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 wird die CollectingInk-Eigenschaft überprüft, um festzustellen, ob Vorgänge risikolos ausgeführt werden können, die nur dann durchgeführt werden dürfen, wenn keine Freihandeingaben erfasst werden.

Try
    If Not mInkCollector.CollectingInk Then
        ' do something
    End If
Catch
    ' handle or rethrow
End Try

try
{
    if (!mInkCollector.CollectingInk)
    {
        // do something
    }
}
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.