IntersectClipRect, fonction (wingdi.h)

  • Article

La fonction IntersectClipRect crée une nouvelle zone de découpage à partir de l’intersection de la zone de découpage actuelle et du rectangle spécifié.

Syntaxe

int IntersectClipRect(
  [in] HDC hdc,
  [in] int left,
  [in] int top,
  [in] int right,
  [in] int bottom
);

Paramètres

[in] hdc

Handle pour le contexte de l’appareil.

[in] left

Coordonnée x, en unités logiques, du coin supérieur gauche du rectangle.

[in] top

Coordonnée y, en unités logiques, du coin supérieur gauche du rectangle.

[in] right

Coordonnée x, en unités logiques, du coin inférieur droit du rectangle.

[in] bottom

Coordonnée y, en unités logiques, du coin inférieur droit du rectangle.

Valeur retournée

La valeur de retour spécifie le type de la nouvelle région de découpage et peut être l’une des valeurs suivantes.

Code de retour Description
NULLREGION
 La région est vide.
SIMPLEREGION
 Region est un rectangle unique.
COMPLEXREGION
 La région est plusieurs rectangles.
ERROR
 Une erreur est survenue. (La zone de découpage actuelle n’est pas affectée.)

Remarques

Les bords inférieur et droit du rectangle donné sont exclus de la zone de découpage.

S’il n’existe pas encore de région de découpage, le système peut appliquer une région de découpage par défaut au HDC spécifié. Une zone de découpage est ensuite créée à partir de l’intersection de cette région de découpage par défaut et du rectangle spécifié dans les paramètres de fonction.

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 wingdi.h (inclure Windows.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

Fonctions de découpage

Vue d’ensemble du découpage

ExcludeClipRect