InkAnalyzer.Reconcile, méthode (Int64)

Article
11/05/2008

Mise à jour : November 2007

Exécute le rapprochement de InkAnalyzer à l'aide d'un contrôle sur la durée d'exécution de l'opération de rapprochement.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink.Analysis (dans Microsoft.Ink.Analysis.dll)

Syntaxe

'Déclaration
Public Function Reconcile ( _
    timeLimit As Long _
) As Boolean
'Utilisation
Dim instance As InkAnalyzer
Dim timeLimit As Long
Dim returnValue As Boolean

returnValue = instance.Reconcile(timeLimit)

public bool Reconcile(
    long timeLimit
)

public:
bool Reconcile(
    long long timeLimit
)

public boolean Reconcile(
    long timeLimit
)

public function Reconcile(
    timeLimit : long
) : boolean

Paramètres

timeLimit
Type : System.Int64
Durée (en millisecondes) autorisée par l'application pour terminer une transaction. Il s'agit d'une indication et non d'une contrainte stricte. Les valeurs valides sont comprises entre 0 et (max long/10 000). Une exception ArgumentOutOfRange (page pouvant être en anglais) est déclenchée si cette méthode est appelée avec une valeur non valide.

Valeur de retour

Type : System.Boolean
true pour continuer le rapprochement, false si le rapprochement est terminé.

Notes

Les utilisateurs peuvent souhaiter contrôler la durée d'exécution d'une opération de rapprochement sur le thread de l'interface utilisateur. L'appel du rapprochement avec le paramètre timeLimit déclenche une transaction qui s'exécute jusqu'à ce que la limite de temps ait été atteinte ou que la liste de modifications ait été complétée. L'événement de résultats sera déclenché uniquement une fois la liste de modifications complétée.

À la fin d'une transaction, la validité de l'arborescence est garantie. Un état valide est défini par l'absence d'enfants sans parents et de parents sans enfants (conteneurs sans nœuds, nœuds terminaux sans traits).

Les événements PropertiesChanged et StrokesReparented sont mis en mémoire cache jusqu'à la fin d'une transaction et un événement unique est déclenché avant le retour de la méthode Reconcile.

Au moins une transaction est effectuée pour chaque appel à la méthode Reconcile avec un paramètre temporel valide.

Plateformes

Windows Vista

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.