ScrollDC, fonction (winuser.h)

Article
08/28/2023

La fonction ScrollDC fait défiler un rectangle de bits horizontalement et verticalement.

Syntaxe

BOOL ScrollDC(
  [in]  HDC        hDC,
  [in]  int        dx,
  [in]  int        dy,
  [in]  const RECT *lprcScroll,
  [in]  const RECT *lprcClip,
  [in]  HRGN       hrgnUpdate,
  [out] LPRECT     lprcUpdate
);

Paramètres

[in] hDC

Type : HDC

Gérez le contexte de l’appareil qui contient les bits à faire défiler.

[in] dx

Type : int

Spécifie la quantité, en unités d’appareil, de défilement horizontal. Ce paramètre doit être une valeur négative pour faire défiler vers la gauche.

[in] dy

Type : int

Spécifie la quantité, en unités d’appareil, de défilement vertical. Ce paramètre doit être une valeur négative pour faire défiler vers le haut.

[in] lprcScroll

Type : const RECT*

Pointeur vers une structure RECT contenant les coordonnées des bits à faire défiler. Les seuls bits affectés par l’opération de défilement sont les bits de l’intersection de ce rectangle et du rectangle spécifié par lprcClip. Si lprcScroll a la valeur NULL, la zone cliente entière est utilisée.

[in] lprcClip

Type : const RECT*

Pointeur vers une structure RECT contenant les coordonnées du rectangle de découpage. Les seuls bits qui seront peints sont les bits qui restent à l’intérieur de ce rectangle une fois l’opération de défilement terminée. Si lprcClip a la valeur NULL, la zone cliente entière est utilisée.

[in] hrgnUpdate

Type : HRGN

Gérez la région découverte par le processus de défilement. ScrollDC définit cette région ; il ne s’agit pas nécessairement d’un rectangle.

[out] lprcUpdate

Type : LPRECT

Pointeur vers une structure RECT qui reçoit les coordonnées du rectangle englobant la région de mise à jour de défilement. Il s’agit de la plus grande zone rectangulaire qui nécessite un repeint. Lorsque la fonction retourne, les valeurs de la structure sont dans les coordonnées du client, quel que soit le mode de mappage pour le contexte d’appareil spécifié. Cela permet aux applications d’utiliser la région de mise à jour dans un appel à la fonction InvalidateRgn , si nécessaire.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Si le paramètre lprcUpdate a la valeur NULL, le système ne calcule pas le rectangle de mise à jour. Si les paramètres hrgnUpdate et lprcUpdate ont la valeur NULL, le système ne calcule pas la région de mise à jour. Si hrgnUpdate n’a pas la valeur NULL, le système continue comme s’il contient un handle valide pour la région découverte par le processus de défilement (défini par ScrollDC).

Lorsque vous devez faire défiler l’ensemble de la zone cliente d’une fenêtre, utilisez la fonction ScrollWindowEx .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-misc-l1-5-0 (introduit dans Windows 10, version 10.0.10240)