GetClipRgn, fonction (wingdi.h)

  • Article

La fonction GetClipRgn récupère un handle identifiant la région de découpage définie par l’application actuelle pour le contexte d’appareil spécifié.

Syntaxe

int GetClipRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn
);

Paramètres

[in] hdc

Handle dans le contexte de l’appareil.

[in] hrgn

Handle vers une région existante avant l’appel de la fonction. Une fois la fonction retournée, ce paramètre est un handle vers une copie de la région de découpage actuelle.

Valeur retournée

Si la fonction réussit et qu’il n’y a pas de zone de découpage pour le contexte d’appareil donné, la valeur de retour est zéro. Si la fonction réussit et qu’il existe une zone de découpage pour le contexte d’appareil donné, la valeur de retour est 1. Si une erreur se produit, la valeur de retour est -1.

Remarques

Une région de découpage définie par l’application est une région de découpage identifiée par la fonction SelectClipRgn . Il ne s’agit pas d’une zone de découpage créée lorsque l’application appelle la fonction BeginPaint .

Si la fonction réussit, le paramètre hrgn est un handle vers une copie de la région de découpage actuelle. Les modifications ultérieures apportées à cette copie n’affecteront pas la région de découpage actuelle.

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

BeginPaint

Fonctions de découpage

Vue d’ensemble de la coupe

SelectClipRgn