Découpage des régions

Une zone de découpage est l’un des objets graphiques qu’une application peut sélectionner dans un contexte d’appareil (DC). Il est généralement rectangulaire. Certains contextes d’appareil fournissent une zone de découpage prédéfinie ou par défaut, contrairement à d’autres. Par exemple, si vous obtenez un handle de contexte d’appareil à partir de la fonction BeginPaint , le contrôleur de domaine contient une zone de découpage rectangulaire prédéfinie qui correspond au rectangle non valide qui nécessite un repeint. Toutefois, lorsque vous obtenez un handle de contexte d’appareil en appelant la fonction GetDC avec un paramètre hWndNULL ou en appelant la fonction CreateDC, le contrôleur de domaine ne contient pas de zone de découpage par défaut. Pour plus d’informations sur les contextes d’appareil retournés par la fonction BeginPaint , consultez Peinture et dessin . Pour plus d’informations sur les contextes d’appareil retournés par les fonctions CreateDC et GetDC , consultez Contextes d’appareil.

Les applications peuvent effectuer diverses opérations sur les régions de découpage. Certaines de ces opérations nécessitent un handle identifiant la région, et d’autres non. Par exemple, une application peut effectuer les opérations suivantes directement sur la zone de découpage d’un contexte d’appareil.

• Déterminez si la sortie graphique s’affiche dans les bordures de la région en passant les coordonnées de la ligne, de l’arc, de la bitmap, du texte ou de la forme remplie correspondante à la fonction PtVisible .
• Déterminez si une partie de la zone cliente croise une région en appelant la fonction RectVisible .
• Déplacez la région existante d’un décalage spécifié en appelant la fonction OffsetClipRgn .
• Excluez une partie rectangulaire de la zone cliente de la zone de découpage actuelle en appelant la fonction ExcludeClipRect .
• Combinez une partie rectangulaire de la zone cliente avec la zone de découpage actuelle en appelant la fonction IntersectClipRect .

Après avoir obtenu un handle identifiant la région de découpage, une application peut effectuer toutes les opérations communes aux régions, telles que :

• Combinaison d’une copie de la région de découpage actuelle avec une deuxième région en appelant la fonction CombineRgn .
• Comparez une copie de la région de découpage actuelle à une deuxième région en appelant la fonction EqualRgn .
• Déterminez si un point se trouve à l’intérieur d’une copie de la zone de découpage actuelle en appelant la fonction PtInRegion .