InkOverlay.EditingMode-Eigenschaft

Artikel
10/28/2008

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob sich InkOverlay im Freihandmodus, im Löschmodus oder im Auswahl-/Bearbeitungsmodus befindet.

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

Syntax

'Declaration
<BrowsableAttribute(True)> _
Public Property EditingMode As InkOverlayEditingMode
'Usage
Dim instance As InkOverlay
Dim value As InkOverlayEditingMode

value = instance.EditingMode

instance.EditingMode = value

[BrowsableAttribute(true)]
public InkOverlayEditingMode EditingMode { get; set; }

[BrowsableAttribute(true)]
public:
property InkOverlayEditingMode EditingMode {
    InkOverlayEditingMode get ();
    void set (InkOverlayEditingMode value);
}

/** @property */
/** @attribute BrowsableAttribute(true) */
public InkOverlayEditingMode get_EditingMode()
/** @property */
/** @attribute BrowsableAttribute(true) */
public  void set_EditingMode(InkOverlayEditingMode value)

public function get EditingMode () : InkOverlayEditingMode
public function set EditingMode (value : InkOverlayEditingMode)

Eigenschaftenwert

Typ: Microsoft.Ink.InkOverlayEditingMode
Einer der InkOverlayEditingMode-Werte, die angeben, ob sich InkOverlay im Freihandmodus, im Löschmodus oder im Auswahl-/Bearbeitungsmodus befindet.

Hinweise

Eine Ausnahme wird ausgelöst, wenn Sie die EditingMode-Eigenschaft während der Erfassung von Freihandeingaben ändern. Um diesen Konflikt zu vermeiden, müssen Sie vor einer Änderung der EditingMode-Eigenschaft sicherstellen, dass die CollectingInk-Eigenschaft den Wert false aufweist.

Weitere Informationen zum Löschen von Freihandeingaben finden Sie unter Erasing Ink with the Pen.

Beispiele

Dieses Beispiel zeigt einen Ereignishandler für ein ListBox-Steuerelement, das die EditingMode-Eigenschaft für ein InkOverlay-Objekt ändert.

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.

' SelectedIndexChanged event handler for a list box with 3 mode choices:
'  Ink     (index:0)
'  Erase   (index:1)
'  Select  (index:2)
Private Sub listBoxEditMode_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs)
    Try

        ' mInkObject can be InkOverlay or InkPicture
        If Not mInkObject.CollectingInk Then
            Select Case DirectCast(sender, ListBox).SelectedIndex
                Case 0
                    mInkObject.EditingMode = InkOverlayEditingMode.Ink
                Case 1
                    mInkObject.EditingMode = InkOverlayEditingMode.Delete
                Case 2
                    mInkObject.EditingMode = InkOverlayEditingMode.Select
            End Select
        End If

    Catch
        ' handle or rethrow
    End Try
End Sub

// SelectedIndexChanged event handler for a list box with 3 mode choices:
//  Ink     (index:0)
//  Erase   (index:1)
//  Select  (index:2)
private void listBoxEditMode_SelectedIndexChanged(object sender, EventArgs e)
{
    try
    {
        // mInkObject can be InkOverlay or InkPicture
        if (!mInkObject.CollectingInk)
        {
            switch (((ListBox)sender).SelectedIndex)
            {
                case 0:
                    mInkObject.EditingMode = InkOverlayEditingMode.Ink;
                    break;
                case 1:
                    mInkObject.EditingMode = InkOverlayEditingMode.Delete;
                    break;
                case 2:
                    mInkObject.EditingMode = InkOverlayEditingMode.Select;
                    break;
            }
        }
    }
    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.