InkOverlay.EditingMode (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene o establece un valor que indica si el objeto InkOverlay está en modo de entrada manuscrita, eliminación o selección/edición.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
<BrowsableAttribute(True)> _
Public Property EditingMode As InkOverlayEditingMode
'Uso
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)

Valor de propiedad

Tipo: Microsoft.Ink.InkOverlayEditingMode
Uno de los valores InkOverlayEditingMode que indican si el objeto InkOverlay está en modo de entrada manuscrita, eliminación o selección/edición.

Comentarios

Se produce una excepción si cambia la propiedad EditingMode mientras se recopila la entrada manuscrita. Para evitar este conflicto, asegúrese de que la propiedad CollectingInk es false antes de cambiar la propiedad EditingMode.

Para obtener más información sobre cómo borrar la entrada manuscrita, vea Erasing Ink with the Pen.

Ejemplos

En este ejemplo se muestra un controlador de eventos de un control ListBox que cambia la propiedad EditingMode de un objeto InkOverlay.

No se puede cambiar la propiedad EditingMode mientras el objeto está recopilando entrada manuscrita. Como la recopilación de entrada manuscrita se controla mediante un subproceso independiente del código de la aplicación, la propiedad CollectingInk puede cambiar a true mientras el código de la aplicación funcione con la suposición de que sigue siendo false. Para solventar esta contingencia, el acceso a la propiedad EditingMode se debería incluir dentro de un bloque 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
    }
}

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.