Region Region Region Region Class

Definición

Describe el interior de una forma gráfica formada por rectángulos y rutas. Describes the interior of a graphics shape composed of rectangles and paths. Esta clase no puede heredarse. 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
Herencia
Atributos
Implementaciones

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que es un parámetro de la Paint controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El ejemplo de código muestra cómo usar el Data desde una RegionData objeto para establecer el Data para otra 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

Comentarios

Una región es escalable porque sus coordenadas se especifican en coordenadas universales.A region is scalable because its coordinates are specified in world coordinates. Sin embargo, en una superficie de dibujo, su interior es depende del tamaño y forma de los píxeles que lo representa.On a drawing surface, however, its interior is dependent on the size and shape of the pixels representing it. Una aplicación puede utilizar regiones para recortar el resultado de las operaciones de dibujo.An application can use regions to clip the output of drawing operations. Estas regiones se denominan regiones de recorte.These regions are called clipping regions. Para obtener más información sobre el uso de las regiones de recorte, consulte Cómo: uso de recorte con una región.For more information on using regions for clipping, see How to: Use Clipping with a Region.

Una aplicación también puede usar las regiones en las operaciones de prueba de posicionamiento, como la comprobación de si un punto o un rectángulo forma una intersección con una región.An application can also use regions in hit-testing operations, such as checking whether a point or a rectangle intersects a region. Para obtener más información sobre el uso de las regiones para las pruebas de posicionamiento, consulte How to: Use Hit Testing con una región.For more information on using regions for hit-testing, see How to: Use Hit Testing with a Region.

Una aplicación puede rellenar una región utilizando la Graphics.FillRegion método y un Brush objeto.An application can fill a region by using the Graphics.FillRegion method and a Brush object.

Constructores

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

Inicializa un nuevo objeto Region. Initializes a new Region.

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

Inicializa un nuevo objeto Region con el GraphicsPath especificado. Initializes a new Region with the specified GraphicsPath.

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

Inicializa una nueva Region a partir de la estructura Rectangle especificada. Initializes a new Region from the specified Rectangle structure.

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

Inicializa una nueva Region a partir de la estructura RectangleF especificada. Initializes a new Region from the specified RectangleF structure.

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

Inicializa una nueva instancia de Region a partir de los datos especificados. Initializes a new Region from the specified data.

Métodos

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

Crea una copia exacta de este objeto Region. Creates an exact copy of this Region.

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

Actualiza esta Region para que contenga la parte de la GraphicsPath especificada que no forma una intersección con esta 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)

Actualiza esta Region para que contenga la parte de la estructura Rectangle especificada que no forma una intersección con esta 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)

Actualiza esta Region para que contenga la parte de la estructura RectangleF especificada que no forma una intersección con esta 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)

Actualiza esta Region para que contenga la parte de la Region especificada que no forma una intersección con esta 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)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. 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()

Libera todos los recursos utilizados por este Region. Releases all resources used by this Region.

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

Determina si el objeto especificado es igual al objeto actual. 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)

Comprueba si la Region especificada es idéntica a esta Region en la superficie de dibujo especificada. Tests whether the specified Region is identical to this Region on the specified drawing surface.

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

Actualiza esta Region para que contenga solo la parte de su interior que no forma una intersección con el GraphicsPath especificado. 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)

Actualiza esta Region para que contenga solo la parte de su interior que no forma una intersección con la estructura Rectangle especificada. 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)

Actualiza esta Region para que contenga solo la parte de su interior que no forma una intersección con la estructura RectangleF especificada. 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)

Actualiza esta Region para que contenga solo la parte de su interior que no forma una intersección con el Region especificado. Updates this Region to contain only the portion of its interior that does not intersect with the specified Region.

Finalize() Finalize() Finalize() Finalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados. 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)

Inicializa una nueva región Region a partir del identificador de la región GDIGDI existente especificada. Initializes a new Region from a handle to the specified existing GDIGDI region.

GetBounds(Graphics) GetBounds(Graphics) GetBounds(Graphics) GetBounds(Graphics)

Obtiene una estructura RectangleF que representa un rectángulo que delimita esta Region en la superficie de dibujo de un objeto 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()

Sirve como la función hash predeterminada. Serves as the default hash function.

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

Devuelve un identificador de Windows de esta Region en el contexto de gráficos especificado. Returns a Windows handle to this Region in the specified graphics context.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

Devuelve RegionData que representan la información que describe esta Region. Returns a RegionData that represents the information that describes this Region.

GetRegionScans(Matrix) GetRegionScans(Matrix) GetRegionScans(Matrix) GetRegionScans(Matrix)

Devuelve una matriz de estructuras RectangleF que se aproxima a esta Region después de que se aplique la transformación de matriz especificada. Returns an array of RectangleF structures that approximate this Region after the specified matrix transformation is applied.

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

Obtiene el Type de la instancia actual. Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. Obtains a lifetime service object to control the lifetime policy for this instance.

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

Actualiza Region con la intersección entre él mismo y GraphicsPath especificado. Updates this Region to the intersection of itself with the specified GraphicsPath.

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

Actualiza Region con la intersección entre él mismo y la estructura Rectangle especificada. Updates this Region to the intersection of itself with the specified Rectangle structure.

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

Actualiza Region con la intersección entre él mismo y la estructura RectangleF especificada. Updates this Region to the intersection of itself with the specified RectangleF structure.

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

Actualiza Region con la intersección entre él mismo y Region especificado. Updates this Region to the intersection of itself with the specified Region.

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

Comprueba si esta Region tiene el interior vacío en la superficie de dibujo especificada. Tests whether this Region has an empty interior on the specified drawing surface.

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

Comprueba si esta Region tiene un interior infinito en la superficie de dibujo especificada. 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)

Comprueba si el punto especificado está dentro de este objeto Region cuando se dibuja con el objeto Graphics especificado. 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)

Comprueba si alguna parte del rectángulo especificado está dentro de este 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)

Comprueba si alguna parte del rectángulo especificado está dentro de esta Region cuando se dibuja mediante el Graphics especificado. 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)

Comprueba si la estructura Point especificada está dentro de esta Region. Tests whether the specified Point structure is contained within this Region.

IsVisible(Point, Graphics) IsVisible(Point, Graphics) IsVisible(Point, Graphics) IsVisible(Point, Graphics)

Comprueba si la estructura Point especificada está dentro de esta Region cuando se dibuja con el Graphics especificado. 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)

Comprueba si la estructura PointF especificada está dentro de esta Region. Tests whether the specified PointF structure is contained within this Region.

IsVisible(PointF, Graphics) IsVisible(PointF, Graphics) IsVisible(PointF, Graphics) IsVisible(PointF, Graphics)

Comprueba si la estructura PointF especificada está dentro de esta Region cuando se dibuja con el Graphics especificado. 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)

Comprueba si alguna parte de la estructura Rectangle especificada está dentro de esta 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)

Comprueba si alguna parte de la estructura Rectangle especificada está dentro de esta Region cuando se dibuja mediante el Graphics especificado. 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)

Comprueba si alguna parte de la estructura RectangleF especificada está dentro de esta 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)

Comprueba si alguna parte de la estructura RectangleF especificada está dentro de esta Region cuando se dibuja mediante el Graphics especificado. 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)

Comprueba si el punto especificado está dentro de esta Region. 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)

Comprueba si el punto especificado está dentro de esta Region cuando se dibuja con el Graphics especificado. 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)

Comprueba si alguna parte del rectángulo especificado está dentro de este 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)

Comprueba si alguna parte del rectángulo especificado está dentro de esta Region cuando se dibuja mediante el Graphics especificado. Tests whether any portion of the specified rectangle is contained within this Region when drawn using the specified Graphics.

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

Inicializa esta Region con un interior vacío. Initializes this Region to an empty interior.

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

Inicializa este objeto Region con un interior infinito. Initializes this Region object to an infinite interior.

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

Crea una copia superficial del Object actual. Creates a shallow copy of the current Object.

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

Crea una copia superficial del objeto MarshalByRefObject actual. Creates a shallow copy of the current MarshalByRefObject object.

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

Libera el identificador de Region. Releases the handle of the Region.

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

Devuelve una cadena que representa el objeto actual. Returns a string that represents the current object.

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

Transforma esta Region mediante la Matrix especificada. Transforms this Region by the specified Matrix.

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

Desplaza las coordenadas de este Region en la cantidad especificada. Offsets the coordinates of this Region by the specified amount.

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

Desplaza las coordenadas de este Region en la cantidad especificada. Offsets the coordinates of this Region by the specified amount.

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

Actualiza esta Region a la unión de ella misma con el GraphicsPath especificado. Updates this Region to the union of itself and the specified GraphicsPath.

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

Actualiza esta Region a la unión de ella misma con la estructura Rectangle especificada. Updates this Region to the union of itself and the specified Rectangle structure.

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

Actualiza esta Region a la unión de ella misma con la estructura RectangleF especificada. Updates this Region to the union of itself and the specified RectangleF structure.

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

Actualiza esta Region a la unión de ella misma con el Region especificado. Updates this Region to the union of itself and the specified Region.

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

Actualiza esta Region a la unión de ella misma, menos la intersección, con el objeto GraphicsPath especificado. Updates this Region to the union minus the intersection of itself with the specified GraphicsPath.

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

Actualiza esta Region a la unión de ella misma, menos la intersección, con la estructura Rectangle especificada. Updates this Region to the union minus the intersection of itself with the specified Rectangle structure.

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

Actualiza esta Region a la unión de ella misma, menos la intersección, con la estructura RectangleF especificada. Updates this Region to the union minus the intersection of itself with the specified RectangleF structure.

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

Actualiza esta Region a la unión de ella misma, menos la intersección, con el objeto Region especificado. Updates this Region to the union minus the intersection of itself with the specified Region.

Se aplica a

Consultar también