InkOverlay.EditingMode, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit une valeur qui indique si le InkOverlay est en mode d'entrée manuscrite, de suppression, de sélection ou d'édition.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
<BrowsableAttribute(True)> _
Public Property EditingMode As InkOverlayEditingMode
'Utilisation
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)

Valeur de propriété

Type : Microsoft.Ink.InkOverlayEditingMode
Une des valeurs InkOverlayEditingMode indiquant si le InkOverlay est en mode d'entrée manuscrite, de suppression, de sélection ou d'édition.

Notes

Une exception est levée si vous modifiez la propriété EditingMode pendant la collecte d'entrée manuscrite. Pour éviter ce conflit, assurez-vous que la propriété CollectingInk a la valeur false avant de modifier la propriété EditingMode.

Pour plus d'informations sur la suppression d'entrée manuscrite, consultez Erasing Ink with the Pen.

Exemples

Cet exemple montre un gestionnaire d'événements pour un contrôle ListBox (page pouvant être en anglais) qui modifie la propriété EditingMode pour un objet InkOverlay.

La propriété EditingMode ne peut pas être modifiée lorsque l'objet collecte l'entrée manuscrite. Étant donné que la collecte d'entrée manuscrite est gérée sur un thread séparé de votre code d'application, la propriété CollectingInk peut prendre la valeur true alors que le code d'application considère qu'elle a toujours la valeur false. Pour gérer cette éventualité, l'accès à la propriété EditingMode doit être contenu dans un bloc 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
    }
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.