Méthode IOleDocumentView ::SetRectComplex (docobj.h)

Article
03/01/2024

Définit les coordonnées rectangulaires de la fenêtre d’affichage, des barres de défilement et de la zone de taille.

Syntaxe

HRESULT SetRectComplex(
  [in] LPRECT prcView,
  [in] LPRECT prcHScroll,
  [in] LPRECT prcVScroll,
  [in] LPRECT prcSizeBox
);

Paramètres

[in] prcView

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

[in] prcHScroll

Pointeur vers une structure RECT contenant les coordonnées de la barre de défilement horizontale.

[in] prcVScroll

Pointeur vers une structure RECT contenant les coordonnées de la barre de défilement verticale.

[in] prcSizeBox

Pointeur vers une structure RECT contenant les coordonnées de la zone de taille.

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_NOTIMPL	L’objet document qui possède cette vue ne prend pas en charge les rectangles complexes.

Remarques

Les cadres d’affichage qui prennent en charge une métaphore de classeur, dans laquelle un document unique comprend plusieurs feuilles ou pages, appellent généralement cette méthode pour définir les coordonnées à utiliser en commun par toutes les feuilles ou pages.

Notes aux appelants

L’appel de IOleDocumentView ::SetRectComplex fait partie de la séquence d’activation normale pour les objets de document qui prennent en charge des rectangles complexes, généralement après 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 ::SetRectComplex ou IOleDocumentView ::SetRect pour indiquer à l’objet d’affichage de se redimensionner aux nouvelles dimensions de la fenêtre.

Notes aux implémenteurs

Les objets document qui prennent en charge des rectangles complexes se marquent avec DOCMISC_SUPPORTCOMPLEXRECTANGLES, comme décrit dans DOCMISC et IOleDocument ::GetDocMiscStatus. Les objets document qui ne prennent pas en charge cette méthode peuvent retourner E_NOTIMPL.

Lors de la réception d’un appel à cette méthode, une vue doit se redimensionner pour s’adapter aux coordonnées spécifiées dans prcView et ajuster ses barres de défilement et sa zone de taille aux zones décrites dans prcHScroll, prcVScroll et prcSizeBox.

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

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

IOleDocument ::GetDocMiscStatus

IOleDocumentView

Partager via