int ScrollWindowEx ( int dx, int dy, LPCRECT lpRectScroll, LPCRECT lpRectClip, CRgn * prgnUpdate, LPRECT lpRectUpdate, UINT flags );
Valeur de retour
La valeur de retour est SIMPLEREGION (zone rectangulaire invalidé), COMPLEXREGION (région invalidée rectangulaire ; rectangles qui se chevauchent) ou NULLREGION (aucune région invalidée), si la fonction a réussi ; sinon, la valeur de retour est erreur.
Paramètres
dx
Spécifie la quantité, en unités de périphérique, de défilement horizontal. Ce paramètre doit avoir une valeur négative pour faire défiler vers la gauche.
dy
Spécifie la quantité, en unités de périphérique, de défilement vertical. Ce paramètre doit avoir une valeur négative pour faire défiler jusqu'à.
lpRectScroll
Points d'une structure RECT qui spécifie la partie de la zone client de la faire défiler. Si ce paramètre est NULL, défiler la zone cliente entière.
lpRectClip
Points d'une structure RECT qui spécifie le rectangle de découpage pour faire défiler. Cette structure a préséance sur le rectangle indiqué par lpRectScroll. Seuls les bits à l'intérieur de ce rectangle sont le défilement. Bits à l'extérieur de ce rectangle sont touchés pas même si ils sont dans le rectangle lpRectScroll . Si ce paramètre est NULL, aucun détourage n'est effectuée sur le rectangle de défilement.
prgnUpdate
Identifie la région qui est modifiée afin de tenir la région invalidée par défilement. Ce paramètre peut être NULL.
lpRectUpdate
Points d'une structure RECT qui recevront les limites du rectangle invalidée par défilement. Ce paramètre peut être NULL.
drapeaux
Peut avoir l'une des valeurs suivantes:
Remarques
Fait défiler le contenu de la zone client d'une fenêtre. Cette fonction est similaire à la ScrollWindow fonction, avec quelques fonctionnalités supplémentaires.
If SW_INVALIDATE and SW_ERASE are not specified, the ScrollWindowEx member function does not invalidate the area that is scrolled away from. If either of these flags is set, ScrollWindowEx invalidates this area. The area is not updated until the application calls the UpdateWindow member function, calls the RedrawWindow member function (specifying RDW_UPDATENOW or RDW_ERASENOW), or retrieves the WM_PAINT message from the application queue.
Si la fenêtre a la style WS_CLIPCHILDREN , les zones de retournés spécifiées par prgnUpdate et lpRectUpdate représentent la superficie totale de la fenêtre de défilement doit être mis à jour, y compris toutes les zones dans les fenêtres enfants qui ont besoin de mise à jour.
Si la SW_SCROLLCHILDREN drapeau est spécifiée, Windows sera update pas correctement l'écran si le défile de la partie d'une fenêtre enfant. La partie de la fenêtre de défilement enfant qui se trouve à l'extérieur du rectangle source n'est pas effacée et pas apparaîtra correctement dans sa nouvelle destination. Utilisation du Error_invalid_dwp_handle fonction Windows move enfant windows qui ne sont pas complètement dans le rectangle lpRectScroll . Le curseur est repositionné si l'indicateur SW_SCROLLCHILDREN est défini et le rectangle de caret croise le rectangle de défilement.
Toutes les coordonnées d'entrée et de sortie (pour lpRectScroll, lpRectClip, lpRectUpdateet prgnUpdate) sont censées pour être en coordonnées client, indépendamment de la question de savoir si la fenêtre a le style de classe CS_OWNDC ou CS_CLASSDC . Utilisation du LPtoDP et fonctions DPtoLP Windows pour convertir vers et à partir des coordonnées logiques, si nécessaire.
Aperçu de CWnd |nbsp ; Membres de la classe | Graphique de la hiérarchie
Voir aussinbsp ;CWnd::RedrawWindow, CDC::ScrollDC, CWnd::ScrollWindow, CWnd::UpdateWindow, :: Error_invalid_dwp_handle, :: ScrollWindowEx