ICoNtextNode 介面

表示物件樹狀結構中的節點,這些物件會建立為筆跡分析的一部分。

成員

ICoNtextNode介面繼承自IUnknown介面。 ICoNtextNode 也有下列類型的成員:

方法

ICoNtextNode介面具有這些方法。

方法 描述
AddCoNtextLink 將新的ICoNtextLink 新增至 ICoNtextNode物件的內容連結集合。
AddPropertyData 新增一段應用程式特定資料。
確認 修改確認類型,控制 IInkAnalyzer 物件可以變更有關 ICoNtextNode的內容。
ContainsPropertyData 判斷 ICoNtextNode 物件是否包含儲存在指定識別碼下的資料。
CreatePartiallyPopulatedSubNode 建立只包含類型、識別碼和位置資訊的子 ICoNtextNode 物件。
CreateSubNode 建立新的子 ICoNtextNode 物件。
DeleteCoNtextLink ICoNtextNode 物件的連結集合中刪除 ICoNtextLink 物件。
DeleteSubNode 移除子 ICoNtextNode
GetCoNtextLinks 擷取代表與其他ICoNtextNode物件關聯性的ICoNtextLink物件集合。
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 [僅限傳統型應用程式]
最低支援的伺服器
都不支援
標頭
IACom.h (也需要 IACom_i.c)
DLL
IACom.dll

另請參閱

ICoNtextNodes

內容節點類型

IInkAnalyzer

筆跡分析參考