Enumerazione ConfirmationType

Articolo
10/29/2008

Aggiornamento: novembre 2007

Definisce i valori che specificano la conferma del tipo che può verificarsi in un oggetto ContextNode.

Questa enumerazione dispone di un attributo FlagsAttribute che consente una combinazione bit per bit dei valori dei membri.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)

Sintassi

'Dichiarazione
<FlagsAttribute> _
Public Enumeration ConfirmationType
'Utilizzo
Dim instance As ConfirmationType

[FlagsAttribute]
public enum ConfirmationType

[FlagsAttribute]
public enum class ConfirmationType

/** @attribute FlagsAttribute */
public enum ConfirmationType

public enum ConfirmationType

Membri

	Nome membro	Descrizione
	None	Specifica che non è applicata alcuna conferma. InkAnalyzer è libero di modificare un nodo di contesto o i relativi discendenti in base alle necessità.
	NodeTypeAndProperties	Specifica che InkAnalyzer non può modificare il tipo o le proprietà del nodo di contesto specificato.
	TopBoundary	Specifica che InkAnalyzer non eseguirà operazioni, inclusa l'aggiunta di input penna o l'unione con altri oggetti ContextNode, che provocano lo spostamento dell'oggetto TopBoundary oltre il limite superiore corrente. Esempio:

Note

È possibile utilizzare NodeTypeAndProperties solo per oggetti ContextNode di tipo InkWord e InkDrawing. In caso contrario, viene generata un'eccezione InvalidOperationException.

Esempi

Nell'esempio seguente viene utilizzato un gestore eventi per l'evento MouseUp in un oggetto Panel, theNotesPanel, che raccoglie l'input penna tramite un oggetto InkCollector, theInkCollector. L'applicazione dispone di un oggetto Boolean, confirmMode impostato da un oggetto MenuItem, confirmMenuItem. In modalità di "conferma", l'utente fa clic su una parola per confermarla (o per disattivare la conferma se il nodo è già confermato). Nell'esempio l'evento di rilascio del mouse MouseUp viene convertito in coordinate di input penna e vengono utilizzati gli oggetti HitTest e FindNodesOfType per trovare i nodi appropriati. Una volta trovati i nodi, viene chiamato l'oggetto Confirm per attivare o disattivare la conferma. Infine, l'applicazione esce dalla modalità di "conferma".

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;
    }

}

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Informazioni sulla versione

.NET Framework

Supportato in: 3.0

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.Ink

ContextNode.Confirm

Condividi tramite