Compartir a través de

IContextNode::GetId (método)

  • Artículo

Recupera el identificador del objeto IContextNode .

Sintaxis

HRESULT GetId(
  [out] GUID *pId
);

Parámetros

pId [out]

Identificador del objeto IContextNode .

Valor devuelto

Para obtener una descripción de los valores devueltos, vea Clases e interfaces : análisis de entrada de lápiz.

Comentarios

El analizador de entrada de lápiz asigna un identificador único a todos los nodos de contexto que crea. Durante el análisis de lápiz, el analizador de lápiz puede cambiar el identificador de un nodo de contexto. Por ejemplo, el analizador de entrada de lápiz puede reclasificar un nodo de palabra como dos nodos de palabra y, a continuación, asignar el identificador original a uno y un nuevo identificador al otro. O bien, el analizador de lápiz puede reclasificar dos nodos de palabra como un nodo de palabra y asignar uno de los identificadores originales al nuevo nodo de palabra.

Ejemplos

En el ejemplo siguiente se muestra un método auxiliar que recupera información sobre un nodo especificado, su parámetro pContextNode . Este método auxiliar devuelve información de los métodos siguientes.

// 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 Value
Cliente mínimo compatible
 Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible
 No se admite ninguno
Encabezado
IACom.h (también requiere IACom_i.c)
Archivo DLL
IACom.dll

Consulte también

IContextNode

Referencia de análisis de lápiz