IOleDocumentView ::Open, méthode (docobj.h)
Affiche un affichage de document dans une fenêtre contextuelle distincte. La sémantique est équivalente à IOleObject ::D oVerb avec OLEIVERB_OPEN.
Syntaxe
HRESULT Open();
Valeur de retour
Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
L'opération a échoué. |
|
Mémoire insuffisante disponible pour l’opération. |
|
Une erreur inattendue s’est produite. |
|
L’objet document qui possède cette vue ne prend pas en charge l’activation de fenêtre distincte. |
Remarques
Un utilisateur qui consulte un objet document dans une application conteneur telle qu’un navigateur ou un « binder » peut souhaiter voir deux affichages ou documents à la fois. Étant donné que le navigateur n’affiche qu’une seule vue à la fois, le conteneur a besoin d’un moyen de demander aux autres vues ou documents de s’afficher eux-mêmes, selon les besoins, dans des fenêtres distinctes. La méthode IOleDocumentView ::Open fournit cette méthode.
Remarques aux appelants
Un appel réussi à IOleDocumentView ::Open doit être suivi d’un appel à IOleDocumentView ::Show pour masquer la fenêtre ou pour afficher la fenêtre et la placer au premier plan. Si la vue est active dans sa fenêtre distincte, un conteneur peut afficher ou masquer la fenêtre autant de fois que nécessaire.Remarques aux implémenteurs
Un objet document indique qu’il ne prend pas en charge l’activation dans une fenêtre distincte en définissant l’indicateur DOCMISC_CANTOPENEDIT status et en retournant E_NOTIMPL aux conteneurs qui appellent cette méthode.L’implémentation se compose principalement de l’objet d’affichage appelant sa propre méthode IOleInPlaceObject ::InPlaceDeactivate , qui laisse l’objet document dans un état en cours d’exécution, mais sans activation sur place. L’interface utilisateur de l’objet document n’est pas visible tant que le conteneur n’appelle pas IOleDocumentView ::Show (voir Notes aux appelants ci-dessus).
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 |