Region Classe

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

Region.cs

Décrit l'intérieur d'une forme graphique composée de rectangles et de chemins d'accès. Cette classe ne peut pas être héritée.

public ref class Region sealed : MarshalByRefObject, IDisposable

public sealed class Region : MarshalByRefObject, IDisposable

type Region = class
    inherit MarshalByRefObject
    interface IDisposable

Public NotInheritable Class Region
Inherits MarshalByRefObject
Implements IDisposable

Héritage

Object

MarshalByRefObject

Region

Implémente

IDisposable

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du Paint gestionnaire d’événements. L’exemple de code montre comment utiliser à Data partir d’un RegionData objet pour définir pour Data un autre RegionData.

private:
   void DemonstrateRegionData2( PaintEventArgs^ e )
   {
      //Create a simple region.
      System::Drawing::Region^ region1 = gcnew System::Drawing::Region( Rectangle(10,10,100,100) );

      // Extract the region data.
      System::Drawing::Drawing2D::RegionData^ region1Data = region1->GetRegionData();
      array<Byte>^data1;
      data1 = region1Data->Data;

      // Create a second region.
      System::Drawing::Region^ region2 = gcnew System::Drawing::Region;

      // Get the region data for the second region.
      System::Drawing::Drawing2D::RegionData^ region2Data = region2->GetRegionData();

      // Set the Data property for the second region to the Data from the first region.
      region2Data->Data = data1;

      // Construct a third region using the modified RegionData of the second region.
      System::Drawing::Region^ region3 = gcnew System::Drawing::Region( region2Data );

      // Dispose of the first and second regions.
      delete region1;
      delete region2;

      // Call ExcludeClip passing in the third region.
      e->Graphics->ExcludeClip( region3 );

      // Fill in the client rectangle.
      e->Graphics->FillRectangle( Brushes::Red, this->ClientRectangle );
      delete region3;
   }

private void DemonstrateRegionData2(PaintEventArgs e)
{

    //Create a simple region.
    Region region1 = new Region(new Rectangle(10, 10, 100, 100));

    // Extract the region data.
    System.Drawing.Drawing2D.RegionData region1Data = region1.GetRegionData();
    byte[] data1;
    data1 = region1Data.Data;

    // Create a second region.
    Region region2 = new Region();

    // Get the region data for the second region.
    System.Drawing.Drawing2D.RegionData region2Data = region2.GetRegionData();

    // Set the Data property for the second region to the Data from the first region.
    region2Data.Data = data1;

    // Construct a third region using the modified RegionData of the second region.
    Region region3 = new Region(region2Data);

    // Dispose of the first and second regions.
    region1.Dispose();
    region2.Dispose();

    // Call ExcludeClip passing in the third region.
    e.Graphics.ExcludeClip(region3);

    // Fill in the client rectangle.
    e.Graphics.FillRectangle(Brushes.Red, this.ClientRectangle);

    region3.Dispose();
}

Private Sub DemonstrateRegionData2(ByVal e As PaintEventArgs)

    'Create a simple region.
    Dim region1 As New Region(New Rectangle(10, 10, 100, 100))

    ' Extract the region data.
    Dim region1Data As System.Drawing.Drawing2D.RegionData = region1.GetRegionData
    Dim data1() As Byte
    data1 = region1Data.Data

    ' Create a second region.
    Dim region2 As New Region

    ' Get the region data for the second region.
    Dim region2Data As System.Drawing.Drawing2D.RegionData = region2.GetRegionData()

    ' Set the Data property for the second region to the Data from the first region.
    region2Data.Data = data1

    ' Construct a third region using the modified RegionData of the second region.
    Dim region3 As New Region(region2Data)

    ' Dispose of the first and second regions.
    region1.Dispose()
    region2.Dispose()

    ' Call ExcludeClip passing in the third region.
    e.Graphics.ExcludeClip(region3)

    ' Fill in the client rectangle.
    e.Graphics.FillRectangle(Brushes.Red, Me.ClientRectangle)

    region3.Dispose()

End Sub

Remarques

Une région est évolutive, car ses coordonnées sont spécifiées dans les coordonnées mondiales. Toutefois, sur une surface de dessin, son intérieur dépend de la taille et de la forme des pixels qui la représentent. Une application peut utiliser des régions pour découper la sortie des opérations de dessin. Ces régions sont appelées régions de découpage. Pour plus d’informations sur l’utilisation de régions pour le découpage, consultez Guide pratique pour utiliser le découpage avec une région.

Une application peut également utiliser des régions dans des opérations de test d’accès, comme vérifier si un point ou un rectangle croise une région. Pour plus d’informations sur l’utilisation de régions pour les tests d’accès, consultez How to: Use Hit Testing with a Region.

Une application peut remplir une région à l’aide de la Graphics.FillRegion méthode et d’un Brush objet .

Notes

Dans .NET 6 et versions ultérieures, le package System.Drawing.Common, qui inclut ce type, est pris en charge uniquement sur les systèmes d’exploitation Windows. L’utilisation de ce type dans les applications multiplateformes provoque des avertissements au moment de la compilation et des exceptions d’exécution. Pour plus d’informations, consultez System.Drawing.Common uniquement pris en charge sur Windows.

Constructeurs

Region()	Initialise un nouveau Region.
Region(GraphicsPath)	Initialise un nouveau Region avec le GraphicsPath spécifié.
Region(Rectangle)	Initialise un nouveau Region à partir de la structure Rectangle spécifiée.
Region(RectangleF)	Initialise un nouveau Region à partir de la structure RectangleF spécifiée.
Region(RegionData)	Initialise un nouveau Region à partir des données spécifiées.

Méthodes

Clone()	Crée une copie exacte de Region.
Complement(GraphicsPath)	Met à jour ce Region pour contenir la partie du GraphicsPath spécifié qui n’interfère pas avec ce Region.
Complement(Rectangle)	Met à jour cet objet Region pour contenir la partie de la structure Rectangle spécifiée qui ne croise pas cet objet Region.
Complement(RectangleF)	Met à jour cet objet Region pour contenir la partie de la structure RectangleF spécifiée qui ne croise pas cet objet Region.
Complement(Region)	Met à jour ce Region pour contenir la partie du Region spécifié qui n’interfère pas avec ce Region.
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par ce Region.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Equals(Region, Graphics)	Teste si le Region spécifié est identique à cet objet Region sur la surface de dessin spécifiée.
Exclude(GraphicsPath)	Met à jour cet objet Region pour contenir uniquement la partie de son intérieur qui ne croise pas le GraphicsPath spécifié.
Exclude(Rectangle)	Met à jour cet objet Region pour contenir uniquement la partie de son intérieur qui ne croise pas la structure Rectangle spécifiée.
Exclude(RectangleF)	Met à jour cet objet Region pour contenir uniquement la partie de son intérieur qui ne croise pas la structure RectangleF spécifiée.
Exclude(Region)	Met à jour cet objet Region pour contenir uniquement la partie de son intérieur qui ne croise pas le Region spécifié.
Finalize()	Autorise un objet à tenter de libérer des ressources et à exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par une opération garbage collection.
FromHrgn(IntPtr)	Initialise un nouveau Region à partir d’un handle vers la région GDI existante spécifiée.
GetBounds(Graphics)	Obtient une structure RectangleF qui représente un rectangle qui lie cet objet Region sur la surface de dessin d'un objet Graphics.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetHrgn(Graphics)	Retourne un handle Windows à cet objet Region dans le contexte graphique spécifié.
GetLifetimeService()	Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetRegionData()	Retourne un RegionData qui représente les informations qui décrivent cet objet Region.
GetRegionScans(Matrix)	Retourne un tableau de structures RectangleF qui se rapprochent de cet objet Region après que la transformation de matrice spécifiée a été appliquée.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
Intersect(GraphicsPath)	Met à jour ce Region sur l’intersection entre celui-ci et le GraphicsPath spécifié.
Intersect(Rectangle)	Met à jour cette Region sur l’intersection entre celui-ci et la structure Rectangle spécifiée.
Intersect(RectangleF)	Met à jour cette Region sur l’intersection entre celui-ci et la structure RectangleF spécifiée.
Intersect(Region)	Met à jour ce Region sur l’intersection entre celui-ci et le Region spécifié.
IsEmpty(Graphics)	Teste si cet objet Region possède un intérieur vide sur la surface de dessin spécifiée.
IsInfinite(Graphics)	Teste si cet objet Region possède un intérieur infini sur la surface de dessin spécifiée.
IsVisible(Int32, Int32, Graphics)	Teste si le point spécifié est contenu dans cet objet Region lorsqu'il est dessiné à l'aide de l'objet Graphics spécifié.
IsVisible(Int32, Int32, Int32, Int32)	Teste si une partie du rectangle spécifié est contenue dans cet objet Region.
IsVisible(Int32, Int32, Int32, Int32, Graphics)	Teste si une partie du rectangle spécifié est contenue dans cet objet Region lorsqu'elle est dessinée à l'aide du Graphics spécifié.
IsVisible(Point)	Teste si la structure Point spécifiée est contenue dans cet objet Region.
IsVisible(Point, Graphics)	Teste si la structure Point spécifiée est contenue dans cet objet Region si elle est dessinée à l'aide du Graphics spécifié.
IsVisible(PointF)	Teste si la structure PointF spécifiée est contenue dans cet objet Region.
IsVisible(PointF, Graphics)	Teste si la structure PointF spécifiée est contenue dans cet objet Region si elle est dessinée à l'aide du Graphics spécifié.
IsVisible(Rectangle)	Teste si une partie de la structure Rectangle spécifiée est contenue dans cet objet Region.
IsVisible(Rectangle, Graphics)	Teste si une partie de la structure Rectangle spécifiée est contenue dans cet objet Region lorsqu'elle est dessinée à l'aide du Graphics spécifié.
IsVisible(RectangleF)	Teste si une partie de la structure RectangleF spécifiée est contenue dans cet objet Region.
IsVisible(RectangleF, Graphics)	Teste si une partie de la structure RectangleF spécifiée est contenue dans cet objet Region lorsqu'elle est dessinée à l'aide du Graphics spécifié.
IsVisible(Single, Single)	Teste si Region contient le point spécifié.
IsVisible(Single, Single, Graphics)	Teste si le point spécifié est contenu dans cet objet Region lorsqu'il est dessiné à l'aide du Graphics spécifié.
IsVisible(Single, Single, Single, Single)	Teste si une partie du rectangle spécifié est contenue dans cet objet Region.
IsVisible(Single, Single, Single, Single, Graphics)	Teste si une partie du rectangle spécifié est contenue dans cet objet Region lorsqu'elle est dessinée à l'aide du Graphics spécifié.
MakeEmpty()	Initialise cet objet Region avec un intérieur vide.
MakeInfinite()	Initialise cet objet Region avec un intérieur infini.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
ReleaseHrgn(IntPtr)	Libère le handle de Region.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
Transform(Matrix)	Transforme cet objet Region en Matrix spécifié.
Translate(Int32, Int32)	Décale les coordonnées de cet objet Region de la valeur spécifiée.
Translate(Single, Single)	Décale les coordonnées de cet objet Region de la valeur spécifiée.
Union(GraphicsPath)	Met à jour cet objet Region avec l'union de celui-ci et du GraphicsPath spécifié.
Union(Rectangle)	Met à jour cet objet Region avec l'union de celui-ci et de la structure Rectangle spécifiée.
Union(RectangleF)	Met à jour cet objet Region avec l'union de celui-ci et de la structure RectangleF spécifiée.
Union(Region)	Met à jour cet objet Region avec l'union de celui-ci et du Region spécifié.
Xor(GraphicsPath)	Met à jour cet objet Region avec l'union moins l'intersection de celui-ci et du GraphicsPath spécifié.
Xor(Rectangle)	Met à jour cet objet Region avec l'union moins l'intersection de celui-ci et de la structure Rectangle spécifiée.
Xor(RectangleF)	Met à jour cet objet Region avec l'union moins l'intersection de celui-ci et de la structure RectangleF spécifiée.
Xor(Region)	Met à jour cet objet Region avec l'union moins l'intersection de celui-ci et du Region spécifié.

Voir aussi

• Rectangle
• GraphicsPath
• Utilisation de régions