IOleDocumentView ::Show, méthode (docobj.h)

Article
03/02/2024

Active ou désactive une vue.

Syntaxe

HRESULT Show(
  [in] BOOL fShow
);

Paramètres

[in] fShow

Si la valeur est TRUE, l’affichage doit s’afficher. Si la valeur est FALSE, l’affichage doit se masquer.

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
E_FAIL	L'opération a échoué.
E_OUTOFMEMORY	Mémoire insuffisante disponible pour le fonctionnement.
E_UNEXPECTED	Une erreur inattendue s’est produite.

Remarques

Appeler Show est la dernière étape de la séquence d’activation, car avant de s’afficher, un objet de document doit savoir exactement quel espace il occupe et disposer de tous ses outils.

Remarques aux appelants

Un appel à cette méthode dans le but d’activer une vue doit suivre les appels à IOleDocumentView ::SetInPlaceSite, IOleDocumentView ::UIActivate et IOleDocumentView ::SetRect (ou IOleDocumentView ::SetRectComplex).

Remarques aux implémenteurs

Les implémentations de cette méthode doivent incarner le pseudocode suivant.

if (fShow)
    {
    In-place activate the view but do not UI activate it.
    Show the view window. 
    }
else
    {
    Call IOleDocumentView::UIActivate(FALSE) on this view
    Hide the view window
    }

Toutes les vues d’un objet de document doivent au moins prendre en charge l’activation sur place ; E_NOTIMPL n’est pas une valeur acceptable.

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	docobj.h