IOleInPlaceActiveObject ::OnDocWindowActivate, méthode (oleidl.h)
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 |