InkOverlay.CollectingInk-Eigenschaft
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.
Versionsinformationen
.NET Framework
Unterstützt in: 3.0