ICoNtextNode 介面
表示物件樹狀結構中的節點，這些物件會建立為筆跡分析的一部分。
成員
ICoNtextNode介面繼承自IUnknown介面。 ICoNtextNode 也有下列類型的成員：
方法
ICoNtextNode介面具有這些方法。
| 方法 | Description |
|---|---|
| AddCoNtextLink | 將新的ICoNtextLink 新增至 ICoNtextNode物件的內容連結集合。 |
| AddPropertyData | 新增一段應用程式特定資料。 |
| 確認 | 修改確認類型，控制 IInkAnalyzer 物件可以變更 ICoNtextNode的內容。 |
| ContainsPropertyData | 判斷 ICoNtextNode 物件是否包含儲存在指定識別碼下的資料。 |
| CreatePartiallyPopulatedSubNode | 建立只包含類型、識別碼和位置資訊的子 ICoNtextNode 物件。 |
| CreateSubNode | 建立新的子 ICoNtextNode 物件。 |
| DeleteCoNtextLink | 從 ICoNtextNode 物件的連結集合中刪除 ICoNtextLink 物件。 |
| DeleteSubNode | 移除子 ICoNtextNode。 |
| GetCoNtextLinks | 擷取 ICoNtextLink 物件的集合，代表與其他 ICoNtextNode 物件的關聯性。 |
| GetId | 擷取 ICoNtextNode 物件的識別碼。 |
| GetLocation | 擷取 ICoNtextNode 物件的位置和大小。 |
| GetParentNode | 擷取內容節點樹狀結構中這個 ICoNtextNode 的父節點。 |
| GetPartiallyPopulated | 擷取值，指出 ICoNtextNode 物件是否已部分填入或完全填入。 |
| GetPropertyData | 擷取指定識別碼的應用程式特定資料或其他屬性資料。 |
| GetPropertyDataIds | 擷取有屬性資料的識別碼。 |
| GetStrokeCount | 擷取與 ICoNtextNode 物件相關聯的筆劃數目。 |
| GetStrokeId | 擷取 ICoNtextNode 物件內索引值所參考之筆劃的筆劃識別碼。 |
| GetStrokeIds | 擷取 ICoNtextNode 物件內筆劃的識別碼陣列。 |
| GetStrokePacketDataById | 擷取陣列，其中包含指定筆劃的封包屬性資料。 |
| GetStrokePacketDescriptionById | 擷取陣列，其中包含指定筆劃的封包屬性識別碼。 |
| GetSubNodes | 擷取 ICoNtextNode 物件的直接子節點。 |
| GetType | 擷取 ICoNtextNode 物件的類型。 |
| GetTypeName | 擷取這個 ICoNtextNode的人類可讀取類型名稱。 |
| IsConfirmed | 擷取值，指出是否已確認 ICoNtextNode 物件。
IInkAnalyzer 無法變更已確認 ICoNtextNode 物件的節點類型和相關聯的筆劃。 |
| LoadPropertiesData | 針對先前使用 ICoNtextNode：：SavePropertiesData建立的位元組陣列，重新建立應用程式特定和內部屬性資料。 |
| MoveSubNodeToPosition | 將指定的子 ICoNtextNode 物件重新排列為指定的索引。 |
| RemovePropertyData | 移除應用程式特定資料的片段。 |
| 重新父系 | 將此 ICoNtextNode 物件從其父內容節點的子節點集合移至指定的內容節點子節點集合。 |
| ReparentStrokeByIdToNode | 將筆劃資料從這個 ICoNtextNode 移至指定的 ICoNtextNode。 |
| SavePropertiesData | 擷取位元組陣列，其中包含這個 ICoNtextNode的應用程式特定和內部屬性資料。 |
| SetLocation | 更新這個ICoNtextNode的位置和大小。 |
| SetPartiallyPopulated | 修改值，指出這個 ICoNtextNode 是否部分填入或完全填入。 |
| SetStrokes | 將指定的筆劃與這個 ICoNtextNode產生關聯。 |
備註
節點的類型會在 內容節點類型 常數中描述。
範例
下列範例顯示檢查 ICoNtextNode的方法;方法會執行下列動作：
- 取得內容節點的類型。 如果內容節點是未分類的筆跡、分析提示或自訂辨識器節點，它會呼叫協助程式方法來檢查節點類型的特定屬性。
- 如果節點有子節點，它會藉由呼叫本身來檢查每個子節點。
- 如果節點是筆跡分葉節點，它會呼叫協助程式方法來檢查節點的筆劃資料。
Ihe InkAnalysis API 可讓您建立包含筆跡字和文字字組的線條節點。 不過，剖析器會忽略這些混合節點，並將它們視為外部節點。 這會影響使用者在此混合節點上寫入或繞著這個混合節點寫入時偵測筆跡批註的剖析精確度。
HRESULT CMyClass::ExploreContextNode(
IContextNode *pContextNode)
{
// Check for certain types of context nodes.
GUID ContextNodeType;
HRESULT hr = pContextNode->GetType(&ContextNodeType);
if (SUCCEEDED(hr))
{
if (IsEqualGUID(GUID_CNT_UNCLASSIFIEDINK, ContextNodeType))
{
// Call a helper method that explores unclassified ink nodes.
hr = this->ExploreUnclassifiedInkNode(pContextNode);
}
else if (IsEqualGUID(GUID_CNT_ANALYSISHINT, ContextNodeType))
{
// Call a helper method that explores analysis hint nodes.
hr = this->ExploreAnalysisHintNode(pContextNode);
}
else if (IsEqualGUID(GUID_CNT_CUSTOMRECOGNIZER, ContextNodeType))
{
// Call a helper method that explores custom recognizer nodes.
hr = this->ExploreCustomRecognizerNode(pContextNode);
}
if (SUCCEEDED(hr))
{
// Check if this node is a branch or a leaf node.
IContextNodes *pSubNodes = NULL;
hr = pContextNode->GetSubNodes(&pSubNodes);
if (SUCCEEDED(hr))
{
ULONG ulSubNodeCount;
hr = pSubNodes->GetCount(&ulSubNodeCount);
if (SUCCEEDED(hr))
{
if (ulSubNodeCount > 0)
{
// This node has child nodes; explore each child node.
IContextNode *pSubNode = NULL;
for (ULONG index=0; index<ulSubNodeCount; index++)
{
hr = pSubNodes->GetContextNode(index, &pSubNode);
if (SUCCEEDED(hr))
{
// Recursive call to explore the child node of this
// context node.
hr = this->ExploreContextNode(pSubNode);
}
// Release this reference to the child context node.
if (pSubNode != NULL)
{
pSubNode->Release();
pSubNode = NULL;
}
if (FAILED(hr))
{
break;
}
}
}
else
{
// This is a leaf node. Check if it contains stroke data.
ULONG ulStrokeCount;
hr = pContextNode->GetStrokeCount(&ulStrokeCount);
if (SUCCEEDED(hr))
{
if (ulStrokeCount > 0)
{
// This node is an ink leaf node; call helper
// method that explores available stroke data.
hr = this->ExploreNodeStrokeData(pContextNode);
}
}
}
}
}
// Release this reference to the subnodes collection.
if (pSubNodes != NULL)
{
pSubNodes->Release();
pSubNodes = NULL;
}
}
}
return hr;
}
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows XP Tablet PC Edition [僅限傳統型應用程式] |
| 最低支援的伺服器 |
都不支援 |
| 標頭 |
|
| DLL |
|