IOleInPlaceActiveObject ::OnDocWindowActivate, méthode (oleidl.h)

Article
03/01/2024

Notifie l’objet actif sur place lorsque la fenêtre de document du conteneur est activée ou désactivée.

Syntaxe

HRESULT OnDocWindowActivate(
  [in] BOOL fActivate
);

Paramètres

[in] fActivate

État de la fenêtre de document enfant MDI. Si ce paramètre a la valeur TRUE, la fenêtre est en cours d’activation ; si elle est FALSE, elle est en cours de désactivation.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite.

Remarques

Notes aux appelants

Appelez IOleInPlaceActiveObject ::OnDocWindowActivate lorsque la fenêtre de document enfant MDI est activée ou désactivée et que l’objet est actuellement l’objet actif du document.

Notes aux implémenteurs

Vous devez inclure du code dans cette méthode qui installe les outils au niveau de l’image lors de l’activation d’un objet. Ces outils incluent le menu composite partagé et/ou les barres d’outils et les ornements de cadres facultatifs. Vous devez ensuite vous concentrer. Lors de la désactivation, l’objet doit supprimer les outils au niveau de l’image. Notez que si vous n’appelez pas IOleInPlaceUIWindow ::SetBorderSpace avec pborderwidths défini sur NULL, vous pouvez éviter d’avoir à renégocier l’espace de bordure.

Lors de l’exécution de IOleInPlaceActiveObject ::OnDocWindowActivate, n’appelez pas les fonctions PeekMessage ou GetMessage , ni à une boîte de dialogue. Cela peut entraîner un blocage du système. Il existe d’autres restrictions quant aux méthodes et fonctions d’interface OLE qui peuvent être appelées à partir de IOleInPlaceActiveObject ::OnDocWindowActivate.

Configuration requise

Condition requise	Valeur
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