Region Classe

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v9.0.0-rc.1.24451.1

Source:

Region.cs

Décrit l’intérieur d’une forme graphique composée de rectangles et de chemins. 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 gestionnaire d’événements Paint. L’exemple de code montre comment utiliser le Data à partir d’un objet RegionData pour définir la Data pour 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. Sur une surface de dessin, cependant, son intérieur dépend de la taille et de la forme des pixels représentant celui-ci. 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 la capture avec une région.

Une application peut également utiliser des régions dans des opérations de test de positionnement, telles que la vérification si un point ou un rectangle croise une région. Pour plus d’informations sur l’utilisation de régions pour les tests de positionnement, consultez Guide pratique pour utiliser le test d’accès avec une région.

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

Note

Dans .NET 6 et versions ultérieures, le package System.Drawing.Common, qui inclut ce type, n’est pris en charge que 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 une nouvelle Region.
Region(GraphicsPath)	Initialise une nouvelle Region avec la GraphicsPathspécifiée.
Region(Rectangle)	Initialise une nouvelle Region à partir de la structure de Rectangle spécifiée.
Region(RectangleF)	Initialise une nouvelle Region à partir de la structure de RectangleF spécifiée.
Region(RegionData)	Initialise une nouvelle Region à partir des données spécifiées.

Méthodes

Clone()	Crée une copie exacte de cette Region.
Complement(GraphicsPath)	Met à jour cette Region pour contenir la partie du GraphicsPath spécifié qui ne croise pas cette Region.
Complement(Rectangle)	Met à jour cette Region pour contenir la partie de la structure de Rectangle spécifiée qui ne croise pas cette Region.
Complement(RectangleF)	Met à jour cette Region pour contenir la partie de la structure de RectangleF spécifiée qui ne croise pas cette Region.
Complement(Region)	Met à jour cette Region pour contenir la partie du Region spécifié qui ne croise pas cette Region.
CreateObjRef(Type)	Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par cette 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 à ce Region sur la surface de dessin spécifiée.
Exclude(GraphicsPath)	Met à jour cette Region pour contenir uniquement la partie de son intérieur qui ne croise pas le GraphicsPathspécifié.
Exclude(Rectangle)	Met à jour cette Region pour contenir uniquement la partie de son intérieur qui ne croise pas la structure Rectangle spécifiée.
Exclude(RectangleF)	Met à jour cette Region pour contenir uniquement la partie de son intérieur qui ne croise pas la structure RectangleF spécifiée.
Exclude(Region)	Met à jour cette Region pour contenir uniquement la partie de son intérieur qui ne croise pas le Regionspécifié.
Finalize()	Permet à un objet d’essayer de libérer des ressources et d’effectuer d’autres opérations de nettoyage avant qu’il ne soit récupéré par garbage collection.
FromHrgn(IntPtr)	Initialise une nouvelle Region d’un handle vers la région GDI existante spécifiée.
GetBounds(Graphics)	Obtient une structure RectangleF qui représente un rectangle qui limite cette Region sur la surface de dessin d’un objet Graphics.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetHrgn(Graphics)	Retourne un handle Windows à ce Region dans le contexte graphique spécifié.
GetLifetimeService()	Obsolète. Récupère l’objet de service de durée de vie actuel 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 cette Region.
GetRegionScans(Matrix)	Retourne un tableau de structures RectangleF qui approximativement cette Region après l’application de la transformation de matrice spécifiée.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. 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 cette Region à l’intersection de lui-même avec la GraphicsPathspécifiée.
Intersect(Rectangle)	Met à jour cette Region à l’intersection de lui-même avec la structure Rectangle spécifiée.
Intersect(RectangleF)	Met à jour cette Region à l’intersection de lui-même avec la structure RectangleF spécifiée.
Intersect(Region)	Met à jour cette Region à l’intersection de lui-même avec la Regionspécifiée.
IsEmpty(Graphics)	Teste si cette Region a un intérieur vide sur la surface de dessin spécifiée.
IsInfinite(Graphics)	Teste si cette Region a 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 cette Region.
IsVisible(Int32, Int32, Int32, Int32, Graphics)	Teste si une partie du rectangle spécifié est contenue dans cette Region lorsqu’elle est dessinée à l’aide du Graphicsspécifié.
IsVisible(Point)	Teste si la structure de Point spécifiée est contenue dans cette Region.
IsVisible(Point, Graphics)	Teste si la structure de Point spécifiée est contenue dans cette Region lors d’un dessin à l’aide de la Graphicsspécifiée.
IsVisible(PointF)	Teste si la structure de PointF spécifiée est contenue dans cette Region.
IsVisible(PointF, Graphics)	Teste si la structure de PointF spécifiée est contenue dans cette Region lors d’un dessin à l’aide de la Graphicsspécifiée.
IsVisible(Rectangle)	Teste si une partie de la structure de Rectangle spécifiée est contenue dans cette Region.
IsVisible(Rectangle, Graphics)	Teste si une partie de la structure de Rectangle spécifiée est contenue dans cette Region lorsqu’elle est dessinée à l’aide de la Graphicsspécifiée.
IsVisible(RectangleF)	Teste si une partie de la structure de RectangleF spécifiée est contenue dans cette Region.
IsVisible(RectangleF, Graphics)	Teste si une partie de la structure de RectangleF spécifiée est contenue dans cette Region lorsqu’elle est dessinée à l’aide de la Graphicsspécifiée.
IsVisible(Single, Single)	Teste si le point spécifié est contenu dans cette Region.
IsVisible(Single, Single, Graphics)	Teste si le point spécifié est contenu dans cette Region lorsqu’il est dessiné à l’aide du Graphicsspécifié.
IsVisible(Single, Single, Single, Single)	Teste si une partie du rectangle spécifié est contenue dans cette Region.
IsVisible(Single, Single, Single, Single, Graphics)	Teste si une partie du rectangle spécifié est contenue dans cette Region lorsqu’elle est dessinée à l’aide du Graphicsspécifié.
MakeEmpty()	Initialise cette Region à un intérieur vide.
MakeInfinite()	Initialise cet objet Region à un intérieur infini.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (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 du Region.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
Transform(Matrix)	Transforme cette Region par le Matrixspécifié.
Translate(Int32, Int32)	Décalage les coordonnées de cette Region par la quantité spécifiée.
Translate(Single, Single)	Décalage les coordonnées de cette Region par la quantité spécifiée.
Union(GraphicsPath)	Met à jour cette Region à l’union de lui-même et au GraphicsPathspécifié.
Union(Rectangle)	Met à jour cette Region à l’union de lui-même et à la structure Rectangle spécifiée.
Union(RectangleF)	Met à jour cette Region à l’union de lui-même et à la structure RectangleF spécifiée.
Union(Region)	Met à jour cette Region à l’union de lui-même et au Regionspécifié.
Xor(GraphicsPath)	Met à jour cette Region à l’union moins l’intersection de lui-même avec la GraphicsPathspécifiée.
Xor(Rectangle)	Met à jour cette Region à l’union moins l’intersection de lui-même avec la structure Rectangle spécifiée.
Xor(RectangleF)	Met à jour cette Region à l’union moins l’intersection de lui-même avec la structure RectangleF spécifiée.
Xor(Region)	Met à jour cette Region à l’union moins l’intersection de lui-même avec la Regionspécifiée.

Voir aussi

• Rectangle
• GraphicsPath
• à l’aide de régions