InkAnalyzer.ReadyToReconcile 事件

在墨迹分析器准备好协调后台分析结果和分析器的当前状态时发生。

命名空间:  Microsoft.Ink
程序集:  Microsoft.Ink.Analysis(在 Microsoft.Ink.Analysis.dll 中)

语法

声明
Public Event ReadyToReconcile As ReadyToReconcileEventHandler
用法
Dim instance As InkAnalyzer
Dim handler As ReadyToReconcileEventHandler

AddHandler instance.ReadyToReconcile, handler
public event ReadyToReconcileEventHandler ReadyToReconcile
public:
 event ReadyToReconcileEventHandler^ ReadyToReconcile {
    void add (ReadyToReconcileEventHandler^ value);
    void remove (ReadyToReconcileEventHandler^ value);
}
/** @event */
public void add_ReadyToReconcile (ReadyToReconcileEventHandler value)
/** @event */
public void remove_ReadyToReconcile (ReadyToReconcileEventHandler value)
JScript 不支持事件。

备注

AnalysisModes 属性设置了 AnalysisModes 标志 AutomaticReconciliationEnabled 时,InkAnalyzer 将执行自动协调。如果没有设置 AutomaticReconciliationEnabled 标志,则应用程序需要手动协调后台分析结果。

若要处理手动协调,请执行以下步骤。

  1. 清除 InkAnalyzerAnalysisModes 属性中的 AutomaticReconciliationEnabled 标志。

  2. 为 ReadyToReconcile 事件添加事件处理程序。

  3. 若要协调分析结果,请从 ReadyToReconcile 事件的事件处理程序调用 Reconcile 方法。若要取消当前的后台分析操作,请从 ReadyToReconcile 事件的事件处理程序调用 Abort 方法。

墨迹分析器在引发 InkAnalyzerStateChanging 事件之前引发此事件。

有关将应用程序数据与 InkAnalyzer 同步的更多信息,请参见Data Proxy with Ink Analysis

墨迹分析器在后台分析过程中引发此事件。

示例

下面的示例定义一个方法 theInkAnalyzer_ReadyToReconcile,该方法处理 InkAnalyzer 的 ReadyToReconcile 事件。如果设置了布尔值 abortAnalysis,则 theInkAnalyzerBase_ReadyToReconcile 中止分析操作。否则,该方法执行手动协调并继续执行分析操作。

''' <summary>
''' Handles the StrokeReparentedBase event of an InkAnalyzerBase.
''' </summary>
''' <param name="sender">The source of the event.</param>
''' <param name="e">The event data.</param>
Sub theInkAnalyzer_ReadyToReconcile( _
ByVal sender As Object, _
ByVal e As EventArgs)
    ' The source is an InkAnalyzerBase.
    Dim theInkAnalyzerBase As Microsoft.Ink.InkAnalyzer = _
        DirectCast(sender, Microsoft.Ink.InkAnalyzer)

    ' Check whether or not to abort analysis before continuing.
    If Me.abortAnalysis Then
        ' Abort analysis and update the analyzer's dirty region.
        Dim unanalyzedRegion As Microsoft.Ink.AnalysisRegion = _
            theInkAnalyzerBase.Abort()
        theInkAnalyzerBase.DirtyRegion.Union(unanalyzedRegion)
    Else
        ' Manually reconcile the analysis results for this analysis phase.
        theInkAnalyzerBase.Reconcile()
    End If

End Sub 'theInkAnalyzer_ReadyToReconcile
/// <summary>
/// Handles the ReadyToReconcile event of an InkAnalyzerBase.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
void theInkAnalyzer_ReadyToReconcile(object sender, EventArgs e)
{
    // The source is an InkAnalyzer.
    Microsoft.Ink.InkAnalyzer theInkAnalyzerBase =
        sender as Microsoft.Ink.InkAnalyzer;

    // Check whether or not to abort analysis before continuing.
    if (this.abortAnalysis)
    {
        // Abort analysis and update the analyzer's dirty region.
        Microsoft.Ink.AnalysisRegion unanalyzedRegion =
            theInkAnalyzerBase.Abort();
        theInkAnalyzerBase.DirtyRegion.Union(unanalyzedRegion);
    }
    else
    {
        // Manually reconcile the analysis results for this analysis phase.
        theInkAnalyzerBase.Reconcile();
    }
}

平台

Windows Vista

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求

版本信息

.NET Framework

受以下版本支持:3.0

另请参见

参考

InkAnalyzer 类

InkAnalyzer 成员

Microsoft.Ink 命名空间