Metodo IContextNode::GetId

Articolo
06/13/2023

Recupera l'identificatore per l'oggetto IContextNode .

Sintassi

HRESULT GetId(
  [out] GUID *pId
);

Parametri

pId [out]: Identificatore dell'oggetto IContextNode .

Valore restituito

Per una descrizione dei valori restituiti, vedere Classi e interfacce - Analisi input penna.

Commenti

L'analizzatore input penna assegna un identificatore univoco a tutti i nodi di contesto creati. Durante l'analisi dell'input penna, l'analizzatore input penna può modificare l'identificatore per un nodo di contesto. Ad esempio, l'analizzatore dell'input penna può riclassificare un nodo di parola come due nodi di parola e quindi assegnare l'identificatore originale a uno e un nuovo identificatore all'altro. In alternativa, l'analizzatore dell'input penna può riclassificare due nodi di parola come un nodo di parola e assegnare uno degli identificatori originali al nuovo nodo di parola.

Esempio

Nell'esempio seguente viene illustrato un metodo helper che recupera informazioni su un nodo specificato, il relativo parametro pContextNode . Questo metodo helper restituisce informazioni dai metodi seguenti.

// Helper method for collecting information about a context node.
HRESULT CMyClass::GetNodeInformation(
    IContextNode *pContextNode,
    GUID *pNodeIdentifier,
    GUID *pContextNodeType,
    IAnalysisRegion **ppAnalysisRegion,
    IContextNode **ppParentNode,
    IContextNodes **ppSubNodes)
{
    // Get the identifier of the context node.
    HRESULT hr = pContextNode->GetId(pNodeIdentifier);

    if (FAILED(hr))
    {
        return hr;
    }

    // Get the type identifier for the context node.
    hr = pContextNode->GetType(pContextNodeType);

    if (FAILED(hr))
    {
        return hr;
    }

    // Get the location of the context node.
    hr = pContextNode->GetLocation(ppAnalysisRegion);

    if (FAILED(hr))
    {
        return hr;
    }

    // Get the parent node of the context node.
    hr = pContextNode->GetParentNode(ppParentNode);

    if (FAILED(hr))
    {
        if ((*ppAnalysisRegion) != NULL)
        {
            (*ppAnalysisRegion)->Release();
            (*ppAnalysisRegion) = NULL;
        }
        return hr;
    }

    // Get the subnodes of the context node.
    hr = pContextNode->GetSubNodes(ppSubNodes);

    if (FAILED(hr))
    {
        if (*ppAnalysisRegion)
        {
            (*ppAnalysisRegion)->Release();
            (*ppAnalysisRegion) = NULL;
        }
        if (*ppParentNode)
        {
            (*ppParentNode)->Release();
            (*ppParentNode) = NULL;
        }
        return hr;
    }

    return hr;
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Intestazione	IACom.h (richiede anche IACom_i.c)
DLL	IACom.dll

Vedi anche

IContextNode
Riferimento all'analisi dell'input penna

Share via