Proprietà InkOverlay.EditingMode

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene o imposta un valore che indica se l'oggetto InkOverlay si trova in modalità di input penna, in modalità di eliminazione o in modalità di selezione/modifica.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
<BrowsableAttribute(True)> _
Public Property EditingMode As InkOverlayEditingMode
'Utilizzo
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)

Valore proprietà

Tipo: Microsoft.Ink.InkOverlayEditingMode
Uno dei valori InkOverlayEditingMode che indica se l'oggetto InkOverlay si trova in modalità di input penna, in modalità di eliminazione o in modalità di selezione/modifica.

Note

Viene generata un'eccezione se si modifica la proprietà EditingMode mentre l'input penna viene raccolto. Per evitare questo conflitto, verificare che la proprietà CollectingInk sia false prima di modificare la proprietà EditingMode.

Per ulteriori informazioni sulla cancellazione dell'input penna, vedere Erasing Ink with the Pen.

Esempi

In questo esempio viene illustrato un gestore eventi per un controllo ListBox che modifica la proprietà EditingMode per un oggetto InkOverlay.

Non è possibile modificare la proprietà EditingMode mentre l'oggetto raccoglie l'input penna. Poiché la raccolta dell'input penna viene gestita in un thread separato dal codice dell'applicazione, la proprietà CollectingInk può essere modificata in true mentre il codice dell'applicazione si basa sul fatto che sia ancora false. Per gestire questa situazione, l'accesso alla proprietà EditingMode deve essere contenuto in un blocco try-catch.

' 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
    }
}

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.