IContextNode::GetParentNode, méthode

Récupère le nœud parent de cet IContextNode dans l’arborescence de nœuds de contexte.

Syntaxe

HRESULT GetParentNode(
  [out] IContextNode **ppParentContextNode
);

Paramètres

ppParentContextNode [out]

Pointeur vers le nœud parent de cet objet IContextNode .

Valeur retournée

Pour obtenir une description des valeurs renvoyées, consultez Classes et interfaces - Analyse de l’entrée manuscrite.

Notes

Attention

Pour éviter une fuite de mémoire, appelez IUnknown::Release sur *ppParentContextNode lorsque vous n’avez plus besoin d’utiliser le nœud de contexte parent.

S’il s’agit du nœud racine, le paramètre ppParentContextNode est défini sur NULL.

Exemples

L’exemple suivant montre une méthode d’assistance qui récupère des informations sur un nœud spécifié, son paramètre pContextNode . Cette méthode d’assistance retourne des informations à partir des méthodes suivantes.

• IContextNode::GetId
• IContextNode::GetType
• IContextNode::GetLocation
• IContextNode::GetParentNode

// 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;
}

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablette PC [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
En-tête	IACom.h (nécessite également IACom_i.c)
DLL	IACom.dll

Voir aussi

IContextNode

IContextNode::GetSubNodes

Informations de référence sur l’analyse de l’encre