InkAnalyzerBase.UpdateStrokesCacheBase イベント

2008-10-28

インクアナライザがストロークデータにアクセスする前に発生します。

名前空間 : System.Windows.Ink.AnalysisCore
アセンブリ : IACore (IACore.dll 内)

構文

'宣言
Public Event UpdateStrokesCacheBase As UpdateStrokesCacheBaseEventHandler
'使用
Dim instance As InkAnalyzerBase
Dim handler As UpdateStrokesCacheBaseEventHandler

AddHandler instance.UpdateStrokesCacheBase, handler

public event UpdateStrokesCacheBaseEventHandler UpdateStrokesCacheBase

public:
 event UpdateStrokesCacheBaseEventHandler^ UpdateStrokesCacheBase {
    void add (UpdateStrokesCacheBaseEventHandler^ value);
    void remove (UpdateStrokesCacheBaseEventHandler^ value);
}

/** @event */
public void add_UpdateStrokesCacheBase (UpdateStrokesCacheBaseEventHandler value)
/** @event */
public void remove_UpdateStrokesCacheBase (UpdateStrokesCacheBaseEventHandler value)

JScript では、イベントは使用できません。

解説

インクアナライザは、パケットデータがクリアされた 1 つまたは複数のストロークにアクセスした場合、インク分析時にこのイベントを発生させます。ストロークのパケットデータを更新するには、UpdateStrokeData メソッドまたは UpdateStrokesData メソッドを使用します。

ノードの場所がインクアナライザにより設定されていない場合、インクアナライザは部分的に設定されたインクリーフノードにアクセスするときに、このイベントを発生させません。

アプリケーションデータと InkAnalyzerBase の同期の詳細については、「Data Proxy with Ink Analysis」を参照してください。

例

次の例では、InkAnalyzerBase の UpdateStrokesCacheBase イベントを処理する theInkAnalyzerBase_UpdateStrokesCacheBase メソッドを定義します。このメソッドは、Ink オブジェクト、theInk からストロークデータを取得します。アプリケーションが Ink オブジェクトを使用してストロークデータを格納している場合、アプリケーションは InkAnalyzer 派生クラスを使用する必要があります。

''' <summary>
''' Handles the UpdateStrokesCacheBase event of an InkAnalyzerBase.
''' </summary>
''' <param name="sender">The source of the event.</param>
''' <param name="e">The event data.</param>
''' <remarks>
''' This method converts stroke data to packet data for example only.
''' The InkAnalyzerBase is used when your application is handling packet
''' data. If your application uses stroke data from an Ink object, then
''' you would use InkAnalyzer.
''' </remarks>
Sub theInkAnalyzerBase_UpdateStrokesCacheBase( _
ByVal sender As Object, _
ByVal e As System.Windows.Ink.AnalysisCore.UpdateStrokesCacheBaseEventArgs)
    ' The source is an InkAnalyzerBase.
    Dim theInkAnalyzerBase As System.Windows.Ink.AnalysisCore.InkAnalyzerBase = _
        DirectCast(sender, System.Windows.Ink.AnalysisCore.InkAnalyzerBase)

    ' Add the stroke data to the ink analyzer.
    Dim theStroke As Microsoft.Ink.Stroke
    For Each theStroke In Me.theInk.CreateStrokes(e.GetStrokeIds())
        theInkAnalyzerBase.UpdateStrokeData( _
            theStroke.Id, _
            theStroke.GetPacketData(), _
            theStroke.PacketDescription)
    Next theStroke

End Sub 'theInkAnalyzerBase_UpdateStrokesCacheBase

/// <summary>
/// Handles the UpdateStrokesCacheBase event of an InkAnalyzerBase.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
/// <remarks>
/// This method converts stroke data to packet data for example only.
/// The InkAnalyzerBase is used when your application is handling packet
/// data. If your application uses stroke data from an Ink object, then
/// you would use InkAnalyzer.
/// </remarks>
void theInkAnalyzerBase_UpdateStrokesCacheBase(
    object sender, System.Windows.Ink.AnalysisCore.UpdateStrokesCacheBaseEventArgs e)
{
    // The source is an InkAnalyzerBase.
    System.Windows.Ink.AnalysisCore.InkAnalyzerBase theInkAnalyzerBase =
        sender as System.Windows.Ink.AnalysisCore.InkAnalyzerBase;

    // Add the stroke data to the ink analyzer.
    foreach (Microsoft.Ink.Stroke theStroke
        in this.theInk.CreateStrokes(e.GetStrokeIds()))
    {
        theInkAnalyzerBase.UpdateStrokeData(
            theStroke.Id, theStroke.GetPacketData(),
            theStroke.PacketDescription);
    }
}