Compartilhar via

Método IContextNode::GetLocation

  • Artigo

Recupera a posição e o tamanho do objeto IContextNode .

Sintaxe

HRESULT GetLocation(
  [out] IAnalysisRegion **ppIAnalysisRegion
);

Parâmetros

ppIAnalysisRegion [out]

Um ponteiro para a posição e o tamanho do objeto IContextNode .

Valor retornado

Para obter uma descrição dos valores retornados, consulte Classes e interfaces – Análise de tinta.

Comentários

Cuidado

Para evitar uma perda de memória, chame IUnknown::Release em *ppIAnalysisRegion quando você não precisar mais usar a região de análise.

O local de um nó de contêiner é determinado localizando a união de todos os locais da folha. O local de um nó folha de tinta é determinado pela localização da união da caixa delimitadora dos traços associados. O local de um nó folha sem tinta é definido quando o nó é criado e pode ser atualizado usando IContextNode::SetLocation.

Exemplos

O exemplo a seguir mostra um método auxiliar que recupera informações sobre um nó especificado, seu parâmetro pContextNode . Esse método auxiliar retorna informações dos métodos a seguir.

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

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Nenhum compatível
Cabeçalho
IACom.h (também requer IACom_i.c)
DLL
IACom.dll

Confira também

IContextNode

IAnalysisRegion

IContextNode::SetLocation

Referência de análise de tinta