IInkAnalyzer::AddStrokeForLanguage メソッド
1 つのストロークのストローク データを IInkAnalyzer に 追加し、ストロークに特定のカルチャ識別子を割り当てます。
構文
HRESULT AddStrokeForLanguage(
[in] LONG lStrokeId,
[in] LONG lStrokeLCID,
[in] ULONG ulStrokePacketDataCount,
[in] LONG *plStrokePacketData,
[in] ULONG ulStrokePacketDescriptionCount,
[in] GUID *pStrokePacketDescriptionGuids,
[out] IContextNode **ppContextNodeStrokeAddedTo
);
パラメーター
-
lStrokeId [in]
-
追加するストロークの識別子。
-
lStrokeLCID [in]
-
ストロークに割り当てるカルチャ識別子。
-
ulStrokePacketDataCount [in]
-
ストローク内のパケットの数。
-
plStrokePacketData [in]
-
ストロークのパケット データを含む配列。
-
ulStrokePacketDescriptionCount [in]
-
各パケット内のプロパティの数。
-
pStrokePacketDescriptionGuids [in]
-
パケット プロパティ識別子を含む配列。
-
ppContextNodeStrokeAddedTo [out]
-
新しく追加されたストロークを含む IContextNode のポインターに値が設定されているポインター。
戻り値
戻り値の説明については、「 クラスとインターフェイス - インク分析」を参照してください。
解説
注意事項
メモリ リークを回避するには、 オブジェクトを使用する必要がなくなったときに、ppContextNodeStrokeAddedTo で IUnknown::Release を呼び出します。
ppContextNodeStrokeAddedTo が NULL の場合、呼び出し元がメソッドからの戻り値に関心を持たないことを示します。
IInkAnalyzer は、UnclassifiedInk 型の IContextNode にストロークを追加します (「コンテキスト ノードの種類」を参照)。 このノードは、ルート ノードのサブノード コレクションにあります ( 「IInkAnalyzer::GetRootNode メソッド 」および 「IContextNode::GetSubNodes メソッド」を参照してください)。
IInkAnalyzer は、ストロークに lStrokeLCID カルチャ識別子を割り当て、同じカルチャ識別子を持つストロークを含むインク アナライザーのルート ノードの下にある最初の UnclassifiedInk コンテキスト ノードにストロークを追加します。 インク アナライザーに同じカルチャ識別子を持つノードがない場合は、ルート ノードの下に新しい UnclassifiedInk コンテキスト ノードが作成され、ストロークが新しい UnclassifiedInk コンテキスト ノードに追加されます。
plStrokePacketData には、ストローク内のすべてのポイントのパケット データが含まれています。 pStrokePacketDescriptionGuids には、ストローク内の各ポイントに含まれるパケット データの種類を記述するグローバル一意識別子 (GUID) が含まれています。 使用可能なパケット プロパティの完全な一覧については、「 PacketPropertyGuids 定数」を参照してください。
このメソッドは、領域の現在の値と追加されたストロークの境界ボックスの和集合にダーティ領域を展開します。
IInkAnalyzer に同じストローク識別子を持つストロークが既に含まれている場合、IInkAnalyzer は E_INVALIDARG の HRESULT を返します。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP タブレット PC エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| Header |
|
| [DLL] |
|
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示