ConfirmationType, énumération

Article
11/05/2008

Mise à jour : November 2007

Définit des valeurs qui spécifient la confirmation de type qui peut se produire sur un objet ContextNode.

Cette énumération possède un attribut FlagsAttribute qui permet la combinaison d'opérations de bits de ses valeurs de membres.

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

Syntaxe

'Déclaration
<FlagsAttribute> _
Public Enumeration ConfirmationType
'Utilisation
Dim instance As ConfirmationType

[FlagsAttribute]
public enum ConfirmationType

[FlagsAttribute]
public enum class ConfirmationType

/** @attribute FlagsAttribute */
public enum ConfirmationType

public enum ConfirmationType

Membres

	Nom de membre	Description
	None	Indique qu'aucune confirmation n'est appliquée. Le InkAnalyzer est libre de modifier un nœud de contexte ou un de ses descendants.
	NodeTypeAndProperties	Spécifie que le InkAnalyzer ne peut modifier ni le type ni les propriétés du nœud de contexte spécifié.
	TopBoundary	Spécifie que le InkAnalyzer n'effectue pas d'opérations, y compris l'ajout d'entrées manuscrites ou la fusion avec d'autres ContextNode, qui entraînent le déplacement de TopBoundary au-delà de la limite supérieure active. Par exemple :

Notes

Vous ne pouvez utiliser NodeTypeAndProperties que pour les objets ContextNode de type InkWord et InkDrawing. Sinon, une exception InvalidOperationException (page pouvant être en anglais) est levée.

Exemples

L'exemple suivant est un gestionnaire d'événements pour l'événement MouseUp (page pouvant être en anglais) sur un Panel, theNotesPanel (page pouvant être en anglais), qui collecte des entrées manuscrites via un InkCollector, theInkCollector. L'application dispose d'un Boolean, confirmMode (page pouvant être en anglais) défini par un MenuItem (page pouvant être en anglais), confirmMenuItem. En mode de confirmation, l'utilisateur clique sur un mot pour le confirmer (ou désactiver la confirmation si le nœud est déjà confirmé). L'exemple convertit l'événement de déplacement de la souris vers le haut MouseUp (page pouvant être en anglais) en coordonnées d'entrée manuscrite et utilise les méthodes HitTest et FindNodesOfType pour rechercher les nœuds appropriés. Une fois les nœuds localisés, la méthode Confirm est appelée pour activer/désactiver la confirmation. Enfin, l'application quitte le mode de confirmation.

Private Sub theNotesPanel_MouseUp(ByVal sender As System.Object, ByVal e As System.Windows.Forms.MouseEventArgs) Handles theNotesPanel.MouseUp
    If Me.confirmMode = True Then
        ' Translate coordinates into ink dimensions
        Dim hitPoint As New Point(e.X, e.Y)
        Dim panelGraphics As Graphics = Me.theNotesPanel.CreateGraphics()
        Me.theInkCollector.Renderer.PixelToInkSpace(panelGraphics, hitPoint)
        panelGraphics.Dispose()

        ' Find the strokes that the user selected
        Dim selectedStrokes As Strokes = Me.theInkCollector.Ink.HitTest(hitPoint, 10)

        ' Find the ink word nodes that correspond to those strokes
        Dim selectedNodes As ContextNodeCollection = _
            Me.theInkAnalyzer.FindNodesOfType(Microsoft.Ink.ContextNodeType.InkWord, _
            selectedStrokes)

        ' Toggle the confirmation type on these nodes
        Dim selectedNode As ContextNode
        For Each selectedNode In selectedNodes
            If selectedNode.IsConfirmed(ConfirmationType.NodeTypeAndProperties) = True Then
                selectedNode.Confirm(Microsoft.Ink.ConfirmationType.None)
            Else
                selectedNode.Confirm(Microsoft.Ink.ConfirmationType.NodeTypeAndProperties)
            End If
        Next selectedNode

        ' No longer in "confirm" mode
        Me.confirmMode = False
        Me.ConfirmMenuItem.Checked = False
        Me.theInkCollector.Enabled = True
    End If

End Sub

private void theNotesPanel_MouseUp(object sender, MouseEventArgs e)
{
    if (this.confirmMode)
    {
        // Translate coordinates into ink dimensions
        Point hitPoint = new Point(e.X, e.Y);
        Graphics panelGraphics = this.theNotesPanel.CreateGraphics();
        this.theInkCollector.Renderer.PixelToInkSpace(panelGraphics, ref hitPoint);
        panelGraphics.Dispose();

        // Find the strokes that the user selected
        Strokes selectedStrokes = this.theInkCollector.Ink.HitTest(hitPoint, 10);

        // Find the ink word nodes that correspond to those strokes
        ContextNodeCollection selectedNodes =
            this.theInkAnalyzer.FindNodesOfType(Microsoft.Ink.ContextNodeType.InkWord,
            selectedStrokes);

        // Toggle the confirmation type on these nodes
        foreach (ContextNode selectedNode in selectedNodes)
        {
            if (selectedNode.IsConfirmed(ConfirmationType.NodeTypeAndProperties))
            {
                selectedNode.Confirm(Microsoft.Ink.ConfirmationType.None);
            }
            else
            {
                selectedNode.Confirm(Microsoft.Ink.ConfirmationType.NodeTypeAndProperties);
            }
        }

        // No longer in "confirm" mode
        this.confirmMode = false;
        this.confirmMenuItem.Checked = false;
        this.theInkCollector.Enabled = true;
    }

}

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.

Informations de version

.NET Framework

Pris en charge dans : 3.0

Voir aussi

Référence

Microsoft.Ink, espace de noms

ContextNode.Confirm

Partager via