IViewObject::SetAdvise, méthode (oleidl.h)

Article
08/25/2023

Établit une connexion entre l’objet de vue et un récepteur d’avis afin que le récepteur d’avis puisse être informé des modifications apportées à la vue de l’objet.

Syntaxe

HRESULT SetAdvise(
  [in] DWORD       aspects,
  [in] DWORD       advf,
  [in] IAdviseSink *pAdvSink
);

Paramètres

[in] aspects

Affichage pour lequel la connexion de conseil est en cours de configuration. Les valeurs valides sont extraites de l’énumération DVASPECT. Pour plus d’informations, consultez l’énumération DVASPECT .

[in] advf

Contient un groupe d'indicateurs pour contrôler la connexion consultative. Les valeurs valides proviennent de l’énumération ADVF. Toutefois, seules quelques-unes des valeurs ADVF possibles sont pertinentes pour cette méthode. Le tableau suivant décrit brièvement les valeurs pertinentes. Consultez l’énumération ADVF pour obtenir une description plus détaillée.

Valeur	Signification
ADVF_ONLYONCE	Entraîne la destruction de la connexion de conseil après l’envoi de la première notification.
ADVF_PRIMEFIRST	Provoque l’envoi d’une notification initiale, que les données soient ou non modifiées par rapport à leur état actuel.

Note Les ADVF_ONLYONCE et les ADVF_PRIMEFIRST peuvent être combinés pour fournir un appel asynchrone à IDataObject::GetData.

[in] pAdvSink

Pointeur vers l’interface IAdviseSink sur le récepteur de conseil qui doit être informé des modifications. Une valeur NULL supprime toute connexion d’avis existante.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.

Code de retour	Description
OLE_E_ADVISENOTSUPPORTED	Les notifications d’avis ne sont pas prises en charge.
DV_E_DVASPECT	Valeur non valide pour dwAspect.
E_INVALIDARG	Une ou plusieurs des valeurs fournies ne sont pas valides.
E_OUTOFMEMORY	Mémoire insuffisante disponible pour cette opération.

Notes

Une application conteneur qui demande une opération de dessin sur un objet de vue peut également s’inscrire avec la méthode IViewObject::SetAdvise pour être avertie lorsque la présentation de l’objet view change. Pour savoir quand les données sous-jacentes d’un objet changent, vous devez appeler IDataObject::D Advise séparément.

Pour supprimer une connexion d’avis existante, appelez la méthode IViewObject::SetAdvise avec pAdvSink défini sur NULL.

Si l’objet view change, un appel est effectué au récepteur de conseil approprié via sa méthode IAdviseSink::OnViewChange .

À tout moment, un objet de vue donné ne peut prendre en charge qu’une seule connexion de conseil. Par conséquent, lorsque IViewObject::SetAdvise est appelé et que l’objet de vue tient déjà sur un pointeur récepteur de conseil, OLE libère le pointeur existant avant l’inscription du nouveau.

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	oleidl.h

Voir aussi

ADVF

IAdviseSink

IViewObject

IViewObject::GetAdvise

Partager via