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

Article
02/26/2024

Définit les coordonnées rectangulaires de la fenêtre d’affichage dans laquelle l’affichage doit être activé ou réinitialise les coordonnées de la fenêtre d’affichage dans laquelle une vue est actuellement activée.

Syntaxe

HRESULT SetRect(
  [in] LPRECT prcView
);

Paramètres

[in] prcView

Pointeur vers une structure RECT contenant les coordonnées de la fenêtre d’affichage.

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é.

Remarques

Pour une application d’interface de document unique (SDI), la fenêtre d’affichage est la zone cliente de la fenêtre frame moins l’espace alloué aux barres d’outils, status barre d’outils, etc. Pour une fenêtre d’interface multidocument (MDI), la fenêtre d’affichage est la zone cliente de la fenêtre de document MDI moins tout autre élément d’interface utilisateur au niveau du cadre.

Remarques aux appelants

L’appel de IOleDocumentView ::SetRect ou IOleDocumentView ::SetRectComplex fait partie de la séquence d’activation normale pour les objets document, généralement suite à un appel à IOleDocumentView ::UIActivate et précédant un appel à IOleDocumentView ::Show.

Chaque fois que la fenêtre utilisée pour afficher un objet de document est redimensionnée, le conteneur doit appeler IOleDocumentView ::SetRect (ou IOleDocumentView ::SetRectComplex) pour indiquer à l’objet d’affichage de document qu’il doit se redimensionner aux nouvelles dimensions de la fenêtre.

Remarques aux implémenteurs

Les coordonnées de la fenêtre d’affichage se trouvent dans les coordonnées de la fenêtre d’affichage, qui est obtenue via IOleWindow ::GetWindow. La vue doit se redimensionner pour s’adapter aux nouvelles coordonnées passées dans prcView.

Cette méthode est définie avec l’attribut [input_sync], ce qui signifie que l’objet view ne peut pas générer ou effectuer un autre appel RPC non input_sync lors de l’exécution de cette méthode.

Une vue de document doit implémenter cette méthode complètement ; E_NOTIMPL n’est pas une valeur de retour 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

Voir aussi

IOleDocumentView

Partager via