InkAnalyzerBase.ModifyTopAlternate, méthode (AnalysisAlternateBase, Boolean)

Article
11/05/2008

Mise à jour : November 2007

Définit le AnalysisAlternateBase spécifié comme meilleure proposition de substitution actuelle.

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

Syntaxe

'Déclaration
Public Function ModifyTopAlternate ( _
    alternate As AnalysisAlternateBase, _
    confirmAutomatically As Boolean _
) As Boolean
'Utilisation
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

Paramètres

alternate
Type : System.Windows.Ink.AnalysisCore.AnalysisAlternateBase
Proposition de substitution à définir comme meilleure proposition de substitution.

confirmAutomatically
Type : System.Boolean
true pour appliquer la propriété confirmée de NodeTypeAndProperties à tous les nœuds de contexte terminaux d'entrée manuscrite qui correspondent à une proposition de substitution d'analyse ; false pour leur appliquer la propriété confirmée de None.

Valeur de retour

Type : System.Boolean

Notes

Pour obtenir des propositions de substitution d'analyse, utilisez GetAlternates. Pour obtenir les nœuds de contexte associés à une proposition de substitution d'analyse, utilisez la propriété AnalysisAlternateBase.AlternateNodes.

Pour modifier le type de confirmation d'un nœud de contexte, utilisez ContextNodeBase.Confirm.

Exemples

L'exemple suivant modifie la meilleure proposition de substitution pour le ContextNodeBaseCollection, theLineNodes. Dans cet exemple, theLineNodes contient les nœuds de ligne sélectionnés dans la InkAnalyzerBase, theInkAnalyzerBase. La valeur booléenne confirmationEnabled indique si l'application a activé la confirmation du nœud. Si la confirmation est activée, la valeur booléenne confirmAutomatically indique si le type de confirmation existant est effacé ou conservé.

L'exemple utilise une méthode d'assistance, SelectAnalysisAlternate, pour sélectionner la proposition de substitution d'analyse à définir en tant que meilleure proposition.

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

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.