InkPicture.CollectingInk-Eigenschaft

Artikel
10/28/2008

Ruft einen Wert ab, der angibt, ob Freihandeingaben gerade auf einem InkPicture-Steuerelement 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 InkPicture
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 Freihandeingaben gerade auf einem InkPicture-Steuerelement gezeichnet werden.

Wert	Bedeutung
true	Auf dem InkPicture-Steuerelement werden Freihandeingaben gezeichnet.
false	Auf dem InkPicture-Steuerelement werden keine Freihandeingaben gezeichnet.

Hinweise

Mit der CollectingInk-Eigenschaft können Sie bestimmen, ob auf einem InkPicture-Steuerelement Freihand gezeichnet wird. Das Stroke-Element kann damit nicht überwacht werden.

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 InkPicture-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.