Metodo InkAnalyzerBase.ModifyTopAlternate (AnalysisAlternateBase, Boolean)

Articolo
10/29/2008

Aggiornamento: novembre 2007

Sostituisce la prima alternativa corrente con l'alternativa AnalysisAlternateBase specificata.

Spazio dei nomi: System.Windows.Ink.AnalysisCore
Assembly: IACore (in IACore.dll)

Sintassi

'Dichiarazione
Public Function ModifyTopAlternate ( _
    alternate As AnalysisAlternateBase, _
    confirmAutomatically As Boolean _
) As Boolean
'Utilizzo
Dim instance As InkAnalyzerBase
Dim alternate As AnalysisAlternateBase
Dim confirmAutomatically As Boolean
Dim returnValue As Boolean

returnValue = instance.ModifyTopAlternate(alternate, _
    confirmAutomatically)

public bool ModifyTopAlternate(
    AnalysisAlternateBase alternate,
    bool confirmAutomatically
)

public:
bool ModifyTopAlternate(
    AnalysisAlternateBase^ alternate, 
    bool confirmAutomatically
)

public boolean ModifyTopAlternate(
    AnalysisAlternateBase alternate,
    boolean confirmAutomatically
)

public function ModifyTopAlternate(
    alternate : AnalysisAlternateBase, 
    confirmAutomatically : boolean
) : boolean

Parametri

alternate
Tipo: System.Windows.Ink.AnalysisCore.AnalysisAlternateBase
Alternativa da impostare come prima alternativa.

confirmAutomatically
Tipo: System.Boolean
true per impostare tutti i nodi di contesto foglia dell'input penna che corrispondono all'oggetto alternativa di analisi in modo che dispongano di una proprietà confermata di NodeTypeAndProperties applicata ad essi; false per impostare tutti i nodi di contesto foglia dell'input penna che corrispondono all'oggetto alternativa di analisi in modo che dispongano di una proprietà confermata di None applicata ad essi.

Valore restituito

Tipo: System.Boolean

Note

Per ottenere le alternative di analisi, utilizzare GetAlternates. Per ottenere i nodi di contesto associati a un'alternativa di analisi, utilizzare AnalysisAlternateBase.AlternateNodes.

Per modificare il tipo di conferma per un nodo di contesto, utilizzare ContextNodeBase.Confirm.

Esempi

Nell'esempio seguente viene modificata la prima alternativa per l'oggetto ContextNodeBaseCollection, theLineNodes. In questo esempio, theLineNodes contiene i nodi riga selezionati dall'oggetto InkAnalyzerBase, theInkAnalyzerBase. Il valore Boolean confirmationEnabled indica se l'applicazione ha attivato la conferma del nodo. Se l'applicazione ha attivato la conferma del nodo, il valore Boolean confirmAutomatically indica se il tipo di conferma esistente viene cancellato o mantenuto.

Nell'esempio viene utilizzato un metodo di supporto, SelectAnalysisAlternate, per selezionare l'alternativa di analisi da impostare come prima alternativa.

' Get alternates for the specified line nodes.
Dim theAlternates As System.Windows.Ink.AnalysisCore.AnalysisAlternateBaseCollection = _
    theInkAnalyzerBase.GetAlternates(theLineNodes)

' Use a helper method to get the user's choice of alternate.
Dim selectedAlternate As System.Windows.Ink.AnalysisCore.AnalysisAlternateBase = _
    Me.SelectAnalysisAlternate(theAlternates)

' Set the chosen alternate as the top alternate.
If confirmationEnabled Then
    ' If node confirmation is enabled, use the current setting
    ' of confirmAutomatically to keep or clear the existing
    ' confirmation status of the line nodes.
    theInkAnalyzerBase.ModifyTopAlternate( _
        selectedAlternate, confirmAutomatically)
Else
    ' Otherwise, clear the confirmation as part of modifying
    ' the top alternate.
    theInkAnalyzerBase.ModifyTopAlternate(selectedAlternate)
End If

// Get alternates for the specified line nodes.
System.Windows.Ink.AnalysisCore.AnalysisAlternateBaseCollection theAlternates =
    theInkAnalyzerBase.GetAlternates(theLineNodes);

// Use a helper method to get the user's choice of alternate.
System.Windows.Ink.AnalysisCore.AnalysisAlternateBase selectedAlternate =
    this.SelectAnalysisAlternate(theAlternates);

// Set the chosen alternate as the top alternate.
if (confirmationEnabled)
{
    // If node confirmation is enabled, use the current setting
    // of confirmAutomatically to keep or clear the existing
    // confirmation status of the line nodes.
    theInkAnalyzerBase.ModifyTopAlternate(
        selectedAlternate, confirmAutomatically);
}
else
{
    // Otherwise, clear the confirmation as part of modifying
    // the top alternate.
    theInkAnalyzerBase.ModifyTopAlternate(selectedAlternate);
}

Piattaforme

Windows Vista, Windows XP SP2, Windows Server 2003

.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.