Partager via


IModelKeyReference ::GetContextObject, méthode (dbgmodel.h)

La méthode GetContextObject retourne le contexte (ce pointeur) qui sera passé à la méthode GetValue ou SetValue d’un accesseur de propriété si la clé en question fait référence à un accesseur de propriété. L’objet de contexte retourné ici peut être identique ou non à l’objet d’origine extrait de GetOriginalObject. Si une clé se trouve sur un modèle parent et qu’un ajusteur de contexte est associé à ce modèle parent, l’objet d’origine est l’objet instance sur lequel GetKeyReference ou EnumerateKeyReferences a été appelé. L’objet de contexte serait tout ce qui sort de l’ajusteur de contexte final entre l’objet d’origine et le modèle parent contenant la clé à laquelle cette référence de clé est un handle. S’il n’y a pas d’ajusteurs de contexte, l’objet d’origine et l’objet de contexte sont identiques.

Syntaxe

HRESULT GetContextObject(
  IModelObject **containingObject
);

Paramètres

containingObject

L’objet de contexte qui sera passé à n’importe quelle méthode d’accesseur de propriété est retourné ici.

Valeur retournée

Cette méthode retourne HRESULT qui indique la réussite ou l’échec.

Remarques

Exemple de code

ComPtr<IModelObject> spObject; /* get an object */

ComPtr<IModelKeyReference> spKeyRef;
if (SUCCEEDED(spObject->GetKeyReference(L"Id", &spKeyRef, nullptr)))
{
    ComPtr<IModelObject> spContextObject;
    if (SUCCEEDED(spKeyRef->GetContextObject(&spContextObject)))
    {
        // spObject and spContextObject should be the same.
        // This is *NOT* true if there was an intervening call to OverrideContextObject 
    }
}

Configuration requise

Condition requise Valeur
En-tête dbgmodel.h

Voir aussi

Interface IModelKeyReference