Region Region Region Region Class

Definizione

Descrive la parte interna di una forma grafica composta da rettangoli e tracciati.Describes the interior of a graphics shape composed of rectangles and paths. Questa classe non può essere ereditata.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
Ereditarietà
Attributi
Implementazioni

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgs e, che Paint è un parametro del gestore eventi.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Nell'esempio di codice viene illustrato come utilizzare Data da un RegionData oggetto per impostare Data per un altro RegionDataoggetto.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

Commenti

Un'area è scalabile perché le coordinate sono specificate in coordinate internazionali.A region is scalable because its coordinates are specified in world coordinates. In una superficie di disegno, tuttavia, l'interno dipende dalle dimensioni e dalla forma dei pixel che lo rappresentano.On a drawing surface, however, its interior is dependent on the size and shape of the pixels representing it. Un'applicazione può usare le aree per ritagliare l'output delle operazioni di disegno.An application can use regions to clip the output of drawing operations. Queste aree sono denominate aree di ritaglio.These regions are called clipping regions. Per ulteriori informazioni sull'utilizzo delle aree per il ritaglio , vedere Procedura: Usare il ritaglio con un'area.For more information on using regions for clipping, see How to: Use Clipping with a Region.

Un'applicazione può anche usare aree in operazioni di hit testing, ad esempio verificare se un punto o un rettangolo interseca un'area.An application can also use regions in hit-testing operations, such as checking whether a point or a rectangle intersects a region. Per altre informazioni sull'uso delle aree per l'hit testing , vedere Procedura: Usare l'hit testing conun'area.For more information on using regions for hit-testing, see How to: Use Hit Testing with a Region.

Un'applicazione può riempire un'area usando il Graphics.FillRegion metodo e un Brush oggetto.An application can fill a region by using the Graphics.FillRegion method and a Brush object.

Costruttori

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

Inizializza un nuovo oggetto Region.Initializes a new Region.

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

Inizializza un nuovo oggetto Region con il GraphicsPath specificato.Initializes a new Region with the specified GraphicsPath.

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

Inizializza una nuova classe Region dalla struttura Rectangle specificata.Initializes a new Region from the specified Rectangle structure.

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

Inizializza una nuova classe Region dalla struttura RectangleF specificata.Initializes a new Region from the specified RectangleF structure.

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

Inizializza una nuova classe Region usando i dati specificati.Initializes a new Region from the specified data.

Metodi

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

Crea una copia esatta di questo Region.Creates an exact copy of this Region.

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

Aggiorna questa Region per contenere la parte dell'oggetto GraphicsPath specificato che non si interseca con questa 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)

Aggiorna questa classe Region in modo che contenga la parte della struttura Rectangle specificata che non interseca questa classe 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)

Aggiorna questa classe Region in modo che contenga la parte della struttura RectangleF specificata che non interseca questa classe 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)

Aggiorna questa Region per contenere la parte dell'oggetto Region specificato che non si interseca con questa 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)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto 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()

Rilascia tutte le risorse usate da questa classe Region.Releases all resources used by this Region.

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

Determina se l'oggetto specificato è uguale all'oggetto corrente.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)

Verifica se l'oggetto Region specificato è identico all'oggetto Region sulla superficie di disegno specificata.Tests whether the specified Region is identical to this Region on the specified drawing surface.

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

Aggiorna questa classe Region in modo che contenga solo la sezione della parte interna che non interseca la classe GraphicsPath specificata.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)

Aggiorna questa classe Region in modo che contenga solo la sezione della parte interna che non interseca la struttura Rectangle specificata.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)

Aggiorna questa classe Region in modo che contenga solo la sezione della parte interna che non interseca la struttura RectangleF specificata.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)

Aggiorna questa classe Region in modo che contenga solo la sezione della parte interna che non interseca la classe Region specificata.Updates this Region to contain only the portion of its interior that does not intersect with the specified Region.

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

Consente a un oggetto di effettuare un tentativo di liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperato da 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)

Inizializza un nuovo oggetto Region da un handle nell'area GDIGDI esistente specificata.Initializes a new Region from a handle to the specified existing GDIGDI region.

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

Ottiene una struttura RectangleF che rappresenta un rettangolo che delimita questa classe Region sulla superficie di disegno di un oggettoGraphics.Gets a RectangleF structure that represents a rectangle that bounds this Region on the drawing surface of a Graphics object.

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

Funge da funzione hash predefinita.Serves as the default hash function.

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

Restituisce un handle Windows per questa classe Region nel contesto grafico specificato.Returns a Windows handle to this Region in the specified graphics context.

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

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

Restituisce una classe RegionData che rappresenta le informazioni che descrivono questa classe Region.Returns a RegionData that represents the information that describes this Region.

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

Restituisce una matrice di strutture RectangleF che si approssimano a questa classe Region dopo l'applicazione della matrice di trasformazione.Returns an array of RectangleF structures that approximate this Region after the specified matrix transformation is applied.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Aggiorna questa istanza di Region con la sua intersezione con l'oggetto GraphicsPath specificato.Updates this Region to the intersection of itself with the specified GraphicsPath.

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

Aggiorna questa istanza di Region con la sua intersezione con la struttura Rectangle specificata.Updates this Region to the intersection of itself with the specified Rectangle structure.

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

Aggiorna questa istanza di Region con la sua intersezione con la struttura RectangleF specificata.Updates this Region to the intersection of itself with the specified RectangleF structure.

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

Aggiorna questa istanza di Region con la sua intersezione con l'oggetto Region specificato.Updates this Region to the intersection of itself with the specified Region.

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

Verifica se questa classe Region ha una parte interna vuota sulla superficie di disegno specificata.Tests whether this Region has an empty interior on the specified drawing surface.

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

Verifica se questa classe Region ha una parte interna infinita sulla superficie di disegno specificata.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)

Verifica se il punto specificato è contenuto in questo oggetto Region, quando viene disegnato utilizzando la classe Graphics indicata.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)

Verifica se una parte del rettangolo specificato è contenuta all'interno di questa classe 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)

Verifica se una parte del rettangolo specificato è contenuta all'interno di questa classe Region, quando viene disegnato utilizzando la classe Graphics specificata.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)

Verifica se la struttura Point specificata è contenuta all'interno di questa classe Region.Tests whether the specified Point structure is contained within this Region.

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

Verifica se la struttura Point specificata è contenuta all'interno di questa classe Region, quando viene disegnata utilizzando la classe Graphics specificata.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)

Verifica se la struttura PointF specificata è contenuta all'interno di questa classe Region.Tests whether the specified PointF structure is contained within this Region.

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

Verifica se la struttura PointF specificata è contenuta all'interno di questa classe Region, quando viene disegnata utilizzando la classe Graphics specificata.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)

Verifica se una parte della struttura Rectangle specificata è contenuta all'interno di questa classe 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)

Verifica se una parte della struttura Rectangle specificata è contenuta all'interno di questa classe Region, quando viene disegnata utilizzando la classe Graphics specificata.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)

Verifica se una parte della struttura RectangleF specificata è contenuta all'interno di questa classe 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)

Verifica se una parte della struttura RectangleF specificata è contenuta all'interno di questa classe Region, quando viene disegnata utilizzando la classe Graphics specificata.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)

Verifica se il punto specificato è contenuto all'interno di questa classe 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)

Verifica se il punto specificato è contenuto all'interno di questa classe, Region, quando viene disegnato utilizzando la classe Graphics specificata.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)

Verifica se una parte del rettangolo specificato è contenuta all'interno di questa classe 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)

Verifica se una parte del rettangolo specificato è contenuta all'interno di questa classe Region, quando viene disegnato utilizzando la classe Graphics specificata.Tests whether any portion of the specified rectangle is contained within this Region when drawn using the specified Graphics.

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

Inizializza questa classe Region su una parte interna vuota.Initializes this Region to an empty interior.

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

Inizializza questo oggetto Region su una parte interna infinita.Initializes this Region object to an infinite interior.

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

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

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

Rilascia l'handle della classe Region.Releases the handle of the Region.

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

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

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

Trasforma questa classe Region in base alla classe Matrix specificata.Transforms this Region by the specified Matrix.

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

Esegue l'offset delle coordinate di questa classe Region in base al valore specificato.Offsets the coordinates of this Region by the specified amount.

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

Esegue l'offset delle coordinate di questa classe Region in base al valore specificato.Offsets the coordinates of this Region by the specified amount.

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

Aggiorna questa classe Region all'unione della stessa con la classe GraphicsPath specificata.Updates this Region to the union of itself and the specified GraphicsPath.

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

Aggiorna questa classe Region all'unione della stessa con la struttura Rectangle.Updates this Region to the union of itself and the specified Rectangle structure.

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

Aggiorna questa classe Region all'unione della stessa con la struttura RectangleF.Updates this Region to the union of itself and the specified RectangleF structure.

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

Aggiorna questa classe Region all'unione della stessa con la classe Region specificata.Updates this Region to the union of itself and the specified Region.

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

Aggiorna questa classe Region all'unione meno l'intersezione della stessa con la classe GraphicsPath specificata.Updates this Region to the union minus the intersection of itself with the specified GraphicsPath.

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

Aggiorna questa classe Region all'unione meno l'intersezione della stessa con la struttura Rectangle specificata.Updates this Region to the union minus the intersection of itself with the specified Rectangle structure.

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

Aggiorna questa classe Region all'unione meno l'intersezione della stessa con la struttura RectangleF specificata.Updates this Region to the union minus the intersection of itself with the specified RectangleF structure.

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

Aggiorna questa classe Region all'unione meno l'intersezione della stessa con la classe Region specificata.Updates this Region to the union minus the intersection of itself with the specified Region.

Si applica a

Vedi anche