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
- type
Type : System.Windows.Ink.AnalysisCore.ConfirmationType
ConfirmationType appliqué au nœud.
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