Partager via


ContextNodeBase.Confirm, méthode

Mise à jour : November 2007

Définit le type de confirmation, qui restreint les modifications que le InkAnalyzerBase peut apporter à propos du nœud.

Espace de noms :  System.Windows.Ink.AnalysisCore
Assembly :  IACore (dans IACore.dll)

Syntaxe

'Déclaration
Public Sub Confirm ( _
    type As ConfirmationType _
)
'Utilisation
Dim instance As ContextNodeBase
Dim type As ConfirmationType

instance.Confirm(type)
public void Confirm(
    ConfirmationType type
)
public:
void Confirm(
    ConfirmationType type
)
public void Confirm(
    ConfirmationType type
)
public function Confirm(
    type : ConfirmationType
)

Paramètres

Notes

Utilisez la méthode Confirm pour permettre à l'utilisateur final de confirmer que le InkAnalyzerBase a analysé les traits correctement. Après l'appel à la méthode Confirm, le InkAnalyzerBase ne modifiera pas les objets ContextNodeBase pour ces traits au cours d'une analyse ultérieure.

Par exemple, si l'utilisateur final écrit « bon » et que votre application appelle la méthode Analyze, le InkAnalyzerBase créera un nœud InkWord avec la valeur « bon ». Si l'utilisateur final ajoute « bon » après « jour » pour former un seul mot et que l'application appelle de nouveau la méthode Analyze, le InkAnalyzerBase créera probablement un nœud InkWord avec la valeur « bonjour ». Toutefois, si après le premier appel à la méthode Analyze, l'application appelle Confirm sur le nœud InkWord pour « bon » avec la valeur NodeTypeAndProperties, le résultat n'est pas le même. Lorsque l'utilisateur final ajoute « jour » et que l'application appelle de nouveau la méthode Analyze, le nœud « bon » n'est pas modifié. Le InkAnalyzerBase reconnaîtrait deux nœuds InkWord pour « bon jour ».

Vous ne pouvez confirmer que des objets ContextNodeBase de type InkWord et InkDrawing. Si vous tentez d'appeler Confirm sur un nœud qui n'est pas un nœud terminal, une exception InvalidOperationException est levée.

Si vous appelez InkAnalyzerBase.RemoveStroke, l'objet ContextNodeBase est défini automatiquement comme étant non confirmé si le trait qui est supprimé est associé à un objet ContextNodeBase confirmé.

Les méthodes SetStrokes, SetStrokeType et SetStrokesType lèvent une exception InvalidOperationException si l'objet ContextNodeBase est déjà confirmé. La méthode ReparentStrokes lève l'exception si le nœud de destination ou le nœud source est confirmé.

Exemples

L'exemple suivant est un gestionnaire d'événements pour l'événement MouseUp sur un Panel, theNotesPanel, qui collecte l'entrée manuscrite via un InkCollector nommé theInkCollector. L'application a une valeur Boolean nommée confirmMode, qui est définie par un MenuItem nommé 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 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)

        ' The integer array must be exactly the right size. Arrays
        ' begin at zero, so the upper bound is selectedStrokes.Count - 1.
        Dim selectedStrokeIds(selectedStrokes.Count - 1) As Integer

        For i As Integer = 0 To selectedStrokes.Count - 1
            selectedStrokeIds(i) = selectedStrokes(i).Id
        Next

        ' Find the ink word nodes that correspond to those strokes
        Dim selectedNodes As ContextNodeBaseCollection = _
            Me.theInkAnalyzerBase.FindNodesOfType(System.Windows.Ink.AnalysisCore.ContextNodeTypeBase.InkWord, _
            selectedStrokeIds)

        ' Toggle the confirmation type on these nodes
        Dim selectedNode As ContextNodeBase
        For Each selectedNode In selectedNodes
            If selectedNode.IsConfirmed( _
               Windows.Ink.AnalysisCore.ConfirmationType.NodeTypeAndProperties) Then
                selectedNode.Confirm(System.Windows.Ink.AnalysisCore.ConfirmationType.None)
            Else
                selectedNode.Confirm(System.Windows.Ink.AnalysisCore.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);

        int[] selectedStrokeIds = new int[selectedStrokes.Count];

        for (int i = 0; i < selectedStrokes.Count; i++)
        {
            selectedStrokeIds[i] = selectedStrokes[i].Id;
        }

        // Find the ink word nodes that correspond to those strokes
        ContextNodeBaseCollection selectedNodes =
            this.theInkAnalyzerBase.FindNodesOfType(System.Windows.Ink.AnalysisCore.ContextNodeTypeBase.InkWord,
            selectedStrokeIds);

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

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

}

Plateformes

Windows Vista, Windows XP SP2, Windows Server 2003

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

ContextNodeBase, classe

Membres ContextNodeBase

System.Windows.Ink.AnalysisCore, espace de noms