InkAnalyzerBase.ModifyTopAlternate, méthode (AnalysisAlternateBase)

Article
11/05/2008

Mise à jour : November 2007

Définit le AnalysisAlternateBase spécifié comme étant la meilleure proposition de substitution actuelle et efface le type de confirmation pour tous les nœuds de contexte associés à la proposition.

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

Syntaxe

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

Paramètres

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

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