Region Region Region Region Class

Définition

Décrit l'intérieur d'une forme graphique composée de rectangles et de chemins d'accès.Describes the interior of a graphics shape composed of rectangles and paths. Cette classe ne peut pas être héritée.This class cannot be inherited.

public ref class Region sealed : MarshalByRefObject, IDisposable
[System.Runtime.InteropServices.ComVisible(false)]
public sealed class Region : MarshalByRefObject, IDisposable
type Region = class
    inherit MarshalByRefObject
    interface IDisposable
Public NotInheritable Class Region
Inherits MarshalByRefObject
Implements IDisposable
Héritage
Attributs
Implémente

Exemples

L’exemple de code suivant est conçu pour une utilisation avec Windows Forms et nécessite PaintEventArgs e, qui est un paramètre de la Paint Gestionnaire d’événements.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. L’exemple de code montre comment utiliser le Data à partir d’un RegionData objet à définir le Data pour un autre RegionData.The code example demonstrates how to use the Data from one RegionData object to set the Data for another 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 en coordonnées universelles.A region is scalable because its coordinates are specified in world coordinates. Toutefois, sur une surface de dessin, son intérieur est dépendante de la taille et la forme des pixels qui la représente.On a drawing surface, however, its interior is dependent on the size and shape of the pixels representing it. Une application peut utiliser des régions pour couper le résultat des opérations de dessin.An application can use regions to clip the output of drawing operations. Ces régions sont appelées des régions de découpage.These regions are called clipping regions. Pour plus d’informations sur l’utilisation des régions pour le découpage, consultez Comment : Utiliser le découpage avec une région.For more information on using regions for clipping, see How to: Use Clipping with a Region.

Une application peut également utiliser des régions dans les opérations de test de positionnement, comme par exemple vérifier si un point ou un rectangle entre en intersection avec une région.An application can also use regions in hit-testing operations, such as checking whether a point or a rectangle intersects a region. Pour plus d’informations sur l’utilisation de régions pour le test de positionnement, consultez Comment : Utilisez tests d’atteinte avec une région.For more information on using regions for hit-testing, see How to: Use Hit Testing with a Region.

Une application peut remplir une région à l’aide de la Graphics.FillRegion (méthode) et un Brush objet.An application can fill a region by using the Graphics.FillRegion method and a Brush object.

Constructeurs

Region() Region() Region() Region()

Initialise un nouveau Region.Initializes a new Region.

Region(GraphicsPath) Region(GraphicsPath) Region(GraphicsPath) Region(GraphicsPath)

Initialise un nouveau Region avec le GraphicsPath spécifié.Initializes a new Region with the specified GraphicsPath.

Region(Rectangle) Region(Rectangle) Region(Rectangle) Region(Rectangle)

Initialise un nouveau Region à partir de la structure Rectangle spécifiée.Initializes a new Region from the specified Rectangle structure.

Region(RectangleF) Region(RectangleF) Region(RectangleF) Region(RectangleF)

Initialise un nouveau Region à partir de la structure RectangleF spécifiée.Initializes a new Region from the specified RectangleF structure.

Region(RegionData) Region(RegionData) Region(RegionData) Region(RegionData)

Initialise un nouveau Region à partir des données spécifiées.Initializes a new Region from the specified data.

Méthodes

Clone() Clone() Clone() Clone()

Crée une copie exacte de Region.Creates an exact copy of this Region.

Complement(GraphicsPath) Complement(GraphicsPath) Complement(GraphicsPath) Complement(GraphicsPath)

Met à jour ce Region pour contenir la partie du GraphicsPath spécifié qui ne définit pas d’intersection avec ce Region.Updates this Region to contain the portion of the specified GraphicsPath that does not intersect with this Region.

Complement(Rectangle) Complement(Rectangle) Complement(Rectangle) 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.Updates this Region to contain the portion of the specified Rectangle structure that does not intersect with this Region.

Complement(RectangleF) Complement(RectangleF) Complement(RectangleF) 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.Updates this Region to contain the portion of the specified RectangleF structure that does not intersect with this Region.

Complement(Region) Complement(Region) Complement(Region) Complement(Region)

Met à jour ce Region pour contenir la partie du Region spécifié qui ne définit pas d’intersection avec ce Region.Updates this Region to contain the portion of the specified Region that does not intersect with this Region.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libère toutes les ressources utilisées par ce Region.Releases all resources used by this Region.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Equals(Region, Graphics) Equals(Region, Graphics) Equals(Region, Graphics) Equals(Region, Graphics)

Teste si le Region spécifié est identique à cet objet Region sur la surface de dessin spécifiée.Tests whether the specified Region is identical to this Region on the specified drawing surface.

Exclude(GraphicsPath) Exclude(GraphicsPath) Exclude(GraphicsPath) Exclude(GraphicsPath)

Met à jour cet objet Region pour contenir uniquement la partie de son intérieur qui ne croise pas le GraphicsPath spécifié.Updates this Region to contain only the portion of its interior that does not intersect with the specified GraphicsPath.

Exclude(Rectangle) Exclude(Rectangle) Exclude(Rectangle) 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.Updates this Region to contain only the portion of its interior that does not intersect with the specified Rectangle structure.

Exclude(RectangleF) Exclude(RectangleF) Exclude(RectangleF) 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.Updates this Region to contain only the portion of its interior that does not intersect with the specified RectangleF structure.

Exclude(Region) Exclude(Region) Exclude(Region) Exclude(Region)

Met à jour cet objet Region pour contenir uniquement la partie de son intérieur qui ne croise pas le Region spécifié.Updates this Region to contain only the portion of its interior that does not intersect with the specified Region.

Finalize() Finalize() Finalize() 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.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

FromHrgn(IntPtr) FromHrgn(IntPtr) FromHrgn(IntPtr) FromHrgn(IntPtr)

Initialise une nouvelle Region d'un handle vers la région GDIGDI existante spécifiée.Initializes a new Region from a handle to the specified existing GDIGDI region.

GetBounds(Graphics) GetBounds(Graphics) GetBounds(Graphics) 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.Gets a RectangleF structure that represents a rectangle that bounds this Region on the drawing surface of a Graphics object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetHrgn(Graphics) GetHrgn(Graphics) GetHrgn(Graphics) GetHrgn(Graphics)

Retourne un handle Windows à cet objet Region dans le contexte graphique spécifié.Returns a Windows handle to this Region in the specified graphics context.

GetLifetimeService() GetLifetimeService() GetLifetimeService() 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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetRegionData() GetRegionData() GetRegionData() GetRegionData()

Retourne un RegionData qui représente les informations qui décrivent cet objet Region.Returns a RegionData that represents the information that describes this Region.

GetRegionScans(Matrix) GetRegionScans(Matrix) GetRegionScans(Matrix) 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.Returns an array of RectangleF structures that approximate this Region after the specified matrix transformation is applied.

GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
Intersect(GraphicsPath) Intersect(GraphicsPath) Intersect(GraphicsPath) Intersect(GraphicsPath)

Met à jour ce Region sur l’intersection entre celui-ci et le GraphicsPath spécifié.Updates this Region to the intersection of itself with the specified GraphicsPath.

Intersect(Rectangle) Intersect(Rectangle) Intersect(Rectangle) Intersect(Rectangle)

Met à jour cette Region sur l’intersection entre celui-ci et la structure Rectangle spécifiée.Updates this Region to the intersection of itself with the specified Rectangle structure.

Intersect(RectangleF) Intersect(RectangleF) Intersect(RectangleF) Intersect(RectangleF)

Met à jour cette Region sur l’intersection entre celui-ci et la structure RectangleF spécifiée.Updates this Region to the intersection of itself with the specified RectangleF structure.

Intersect(Region) Intersect(Region) Intersect(Region) Intersect(Region)

Met à jour ce Region sur l’intersection entre celui-ci et le Region spécifié.Updates this Region to the intersection of itself with the specified Region.

IsEmpty(Graphics) IsEmpty(Graphics) IsEmpty(Graphics) IsEmpty(Graphics)

Teste si cet objet Region possède un intérieur vide sur la surface de dessin spécifiée.Tests whether this Region has an empty interior on the specified drawing surface.

IsInfinite(Graphics) IsInfinite(Graphics) IsInfinite(Graphics) IsInfinite(Graphics)

Teste si cet objet Region possède un intérieur infini sur la surface de dessin spécifiée.Tests whether this Region has an infinite interior on the specified drawing surface.

IsVisible(Int32, Int32, Graphics) IsVisible(Int32, Int32, Graphics) IsVisible(Int32, Int32, Graphics) 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é.Tests whether the specified point is contained within this Region object when drawn using the specified Graphics object.

IsVisible(Int32, Int32, Int32, Int32) IsVisible(Int32, Int32, Int32, Int32) IsVisible(Int32, Int32, Int32, Int32) IsVisible(Int32, Int32, Int32, Int32)

Teste si une partie du rectangle spécifié est contenue dans cet objet Region.Tests whether any portion of the specified rectangle is contained within this Region.

IsVisible(Int32, Int32, Int32, Int32, Graphics) IsVisible(Int32, Int32, Int32, Int32, Graphics) IsVisible(Int32, Int32, Int32, Int32, Graphics) 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é.Tests whether any portion of the specified rectangle is contained within this Region when drawn using the specified Graphics.

IsVisible(Point) IsVisible(Point) IsVisible(Point) IsVisible(Point)

Teste si la structure Point spécifiée est contenue dans cet objet Region.Tests whether the specified Point structure is contained within this Region.

IsVisible(Point, Graphics) IsVisible(Point, Graphics) IsVisible(Point, Graphics) 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é.Tests whether the specified Point structure is contained within this Region when drawn using the specified Graphics.

IsVisible(PointF) IsVisible(PointF) IsVisible(PointF) IsVisible(PointF)

Teste si la structure PointF spécifiée est contenue dans cet objet Region.Tests whether the specified PointF structure is contained within this Region.

IsVisible(PointF, Graphics) IsVisible(PointF, Graphics) IsVisible(PointF, Graphics) 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é.Tests whether the specified PointF structure is contained within this Region when drawn using the specified Graphics.

IsVisible(Rectangle) IsVisible(Rectangle) IsVisible(Rectangle) IsVisible(Rectangle)

Teste si une partie de la structure Rectangle spécifiée est contenue dans cet objet Region.Tests whether any portion of the specified Rectangle structure is contained within this Region.

IsVisible(Rectangle, Graphics) IsVisible(Rectangle, Graphics) IsVisible(Rectangle, Graphics) 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é.Tests whether any portion of the specified Rectangle structure is contained within this Region when drawn using the specified Graphics.

IsVisible(RectangleF) IsVisible(RectangleF) IsVisible(RectangleF) IsVisible(RectangleF)

Teste si une partie de la structure RectangleF spécifiée est contenue dans cet objet Region.Tests whether any portion of the specified RectangleF structure is contained within this Region.

IsVisible(RectangleF, Graphics) IsVisible(RectangleF, Graphics) IsVisible(RectangleF, Graphics) 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é.Tests whether any portion of the specified RectangleF structure is contained within this Region when drawn using the specified Graphics.

IsVisible(Single, Single) IsVisible(Single, Single) IsVisible(Single, Single) IsVisible(Single, Single)

Teste si Region contient le point spécifié.Tests whether the specified point is contained within this Region.

IsVisible(Single, Single, Graphics) IsVisible(Single, Single, Graphics) IsVisible(Single, Single, Graphics) 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é.Tests whether the specified point is contained within this Region when drawn using the specified Graphics.

IsVisible(Single, Single, Single, Single) IsVisible(Single, Single, Single, Single) IsVisible(Single, Single, Single, Single) IsVisible(Single, Single, Single, Single)

Teste si une partie du rectangle spécifié est contenue dans cet objet Region.Tests whether any portion of the specified rectangle is contained within this Region.

IsVisible(Single, Single, Single, Single, Graphics) IsVisible(Single, Single, Single, Single, Graphics) IsVisible(Single, Single, Single, Single, Graphics) 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é.Tests whether any portion of the specified rectangle is contained within this Region when drawn using the specified Graphics.

MakeEmpty() MakeEmpty() MakeEmpty() MakeEmpty()

Initialise cet objet Region avec un intérieur vide.Initializes this Region to an empty interior.

MakeInfinite() MakeInfinite() MakeInfinite() MakeInfinite()

Initialise cet objet Region avec un intérieur infini.Initializes this Region object to an infinite interior.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ReleaseHrgn(IntPtr) ReleaseHrgn(IntPtr) ReleaseHrgn(IntPtr) ReleaseHrgn(IntPtr)

Libère le handle de Region.Releases the handle of the Region.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)
Transform(Matrix) Transform(Matrix) Transform(Matrix) Transform(Matrix)

Transforme cet objet Region en Matrix spécifié.Transforms this Region by the specified Matrix.

Translate(Int32, Int32) Translate(Int32, Int32) Translate(Int32, Int32) Translate(Int32, Int32)

Décale les coordonnées de cet objet Region de la valeur spécifiée.Offsets the coordinates of this Region by the specified amount.

Translate(Single, Single) Translate(Single, Single) Translate(Single, Single) Translate(Single, Single)

Décale les coordonnées de cet objet Region de la valeur spécifiée.Offsets the coordinates of this Region by the specified amount.

Union(GraphicsPath) Union(GraphicsPath) Union(GraphicsPath) Union(GraphicsPath)

Met à jour cet objet Region avec l'union de celui-ci et du GraphicsPath spécifié.Updates this Region to the union of itself and the specified GraphicsPath.

Union(Rectangle) Union(Rectangle) Union(Rectangle) Union(Rectangle)

Met à jour cet objet Region avec l'union de celui-ci et de la structure Rectangle spécifiée.Updates this Region to the union of itself and the specified Rectangle structure.

Union(RectangleF) Union(RectangleF) Union(RectangleF) Union(RectangleF)

Met à jour cet objet Region avec l'union de celui-ci et de la structure RectangleF spécifiée.Updates this Region to the union of itself and the specified RectangleF structure.

Union(Region) Union(Region) Union(Region) Union(Region)

Met à jour cet objet Region avec l'union de celui-ci et du Region spécifié.Updates this Region to the union of itself and the specified Region.

Xor(GraphicsPath) Xor(GraphicsPath) Xor(GraphicsPath) Xor(GraphicsPath)

Met à jour cet objet Region avec l'union moins l'intersection de celui-ci et du GraphicsPath spécifié.Updates this Region to the union minus the intersection of itself with the specified GraphicsPath.

Xor(Rectangle) Xor(Rectangle) Xor(Rectangle) Xor(Rectangle)

Met à jour cet objet Region avec l'union moins l'intersection de celui-ci et de la structure Rectangle spécifiée.Updates this Region to the union minus the intersection of itself with the specified Rectangle structure.

Xor(RectangleF) Xor(RectangleF) Xor(RectangleF) Xor(RectangleF)

Met à jour cet objet Region avec l'union moins l'intersection de celui-ci et de la structure RectangleF spécifiée.Updates this Region to the union minus the intersection of itself with the specified RectangleF structure.

Xor(Region) Xor(Region) Xor(Region) Xor(Region)

Met à jour cet objet Region avec l'union moins l'intersection de celui-ci et du Region spécifié.Updates this Region to the union minus the intersection of itself with the specified Region.

S’applique à

Voir aussi