Metodo InkAnalyzerBase.ModifyTopAlternate (AnalysisAlternateBase)

Articolo
10/29/2008

Aggiornamento: novembre 2007

Imposta la prima alternativa corrente su un oggetto AnalysisAlternateBase specificato e cancella il tipo di conferma per tutti i nodi di contesto associati all'alternativa.

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

Sintassi

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

returnValue = instance.ModifyTopAlternate(alternate)

public bool ModifyTopAlternate(
    AnalysisAlternateBase alternate
)

public:
bool ModifyTopAlternate(
    AnalysisAlternateBase^ alternate
)

public boolean ModifyTopAlternate(
    AnalysisAlternateBase alternate
)

public function ModifyTopAlternate(
    alternate : AnalysisAlternateBase
) : boolean

Parametri

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

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