Region Klas

Definitie

Naamruimte:
System.Drawing
Assembly:
System.Drawing.Common.dll
Assembly:
System.Drawing.dll
Pakket:
System.Drawing.Common v11.0.0-preview.4.26230.115
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs
Bron:
Region.cs

Beschrijft het interieur van een grafische vorm die bestaat uit rechthoeken en paden. Deze klasse kan niet worden overgenomen.

public ref class Region sealed : MarshalByRefObject, IDisposable
public sealed class Region : MarshalByRefObject, IDisposable
[System.Runtime.InteropServices.ComVisible(false)]
public sealed class Region : MarshalByRefObject, IDisposable
type Region = class
    inherit MarshalByRefObject
    interface IDisposable
[<System.Runtime.InteropServices.ComVisible(false)>]
type Region = class
    inherit MarshalByRefObject
    interface IDisposable
Public NotInheritable Class Region
Inherits MarshalByRefObject
Implements IDisposable
Overname
Object
MarshalByRefObject
Region
Kenmerken
ComVisibleAttribute
Implementeringen
IDisposable

Voorbeelden

Het volgende codevoorbeeld is ontworpen voor gebruik met Windows Forms en vereist PaintEventArgse, een parameter van de Paint gebeurtenis-handler. In het codevoorbeeld ziet u hoe u het van het Data ene RegionData object gebruikt om de Data voor het andere RegionDatain te stellen.

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

Opmerkingen

Een regio is schaalbaar omdat de coördinaten zijn opgegeven in wereldcoördinaten. Op een tekenoppervlak is het interieur echter afhankelijk van de grootte en vorm van de pixels die het vertegenwoordigen. Een toepassing kan regio's gebruiken om de uitvoer van tekenbewerkingen te knippen. Deze regio's worden knipregio's genoemd. Zie Instructies voor het gebruik van regio's voor het gebruik van regio's : Clipping gebruiken met een regio.

Een toepassing kan ook regio's gebruiken bij bewerkingen voor het testen van treffers, zoals controleren of een punt of rechthoek een regio doorkruist. Zie Instructies voor het gebruik van regio's voor hittests: Hit Testing gebruiken met een regio voor meer informatie over het gebruik van regio's.

Een toepassing kan een regio vullen met behulp van de Graphics.FillRegion methode en een Brush object.

Note

In .NET 6 en latere versies wordt het pakket System.Drawing.Common, dat dit type bevat, alleen ondersteund op Windows-besturingssystemen. Het gebruik van dit type in platformoverschrijdende apps veroorzaakt compileertijdwaarschuwingen en runtime-uitzonderingen. Zie System.Drawing.Common alleen ondersteund in Windows voor meer informatie.

Constructors

Name Description
Region()

Initialiseert een nieuwe Region.
Region(GraphicsPath)

Initialiseert een nieuwe Region met de opgegeven GraphicsPath.
Region(Rectangle)

Initialiseert een nieuwe Region van de opgegeven Rectangle structuur.
Region(RectangleF)

Initialiseert een nieuwe Region van de opgegeven RectangleF structuur.
Region(RegionData)

Initialiseert een nieuwe Region van de opgegeven gegevens.

Methoden

Name Description
Clone()

Hiermee maakt u een exacte kopie van deze Region.
Complement(GraphicsPath)

Hiermee wordt het Region gedeelte bijgewerkt dat het deel van de opgegeven GraphicsPath dat niet met dit Regionkruist.
Complement(Rectangle)

Hiermee wordt het Region gedeelte van de opgegeven Rectangle structuur bijgewerkt dat niet met deze Regionstructuur wordt gekruist.
Complement(RectangleF)

Hiermee wordt het Region gedeelte van de opgegeven RectangleF structuur bijgewerkt dat niet met deze Regionstructuur wordt gekruist.
Complement(Region)

Hiermee wordt het Region gedeelte bijgewerkt dat het deel van de opgegeven Region dat niet met dit Regionkruist.
CreateObjRef(Type)

Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object.

(Overgenomen van MarshalByRefObject)
Dispose()

Alle resources die door deze Regionresources worden gebruikt, worden vrijgegeven.
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
Equals(Region, Graphics)

Test of de opgegeven Region waarde identiek is aan dit Region op het opgegeven tekenoppervlak.
Exclude(GraphicsPath)

Hiermee wordt dit Region bijgewerkt zodat alleen het gedeelte van het interieur dat niet met de opgegeven GraphicsPathintersect.
Exclude(Rectangle)

Hiermee wordt dit Region bijgewerkt zodat alleen het gedeelte van het interieur dat niet met de opgegeven Rectangle structuur kruist.
Exclude(RectangleF)

Hiermee wordt dit Region bijgewerkt zodat alleen het gedeelte van het interieur dat niet met de opgegeven RectangleF structuur kruist.
Exclude(Region)

Hiermee wordt dit Region bijgewerkt zodat alleen het gedeelte van het interieur dat niet met de opgegeven Regionintersect.
Finalize()

Hiermee kan een object resources vrijmaken en andere opschoonbewerkingen uitvoeren voordat het wordt vrijgemaakt door garbagecollection.
FromHrgn(IntPtr)

Initialiseert een nieuwe Region van een ingang naar de opgegeven bestaande GDI-regio.
GetBounds(Graphics)

Hiermee wordt een RectangleF structuur opgehaald die een rechthoek vertegenwoordigt die dit Region begrenst op het tekenoppervlak van een Graphics object.
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetHrgn(Graphics)

Retourneert een Windows ingang naar deze Region in de opgegeven grafische context.
GetLifetimeService()
Verouderd.

Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd.

(Overgenomen van MarshalByRefObject)
GetRegionData()

Retourneert een RegionData die staat voor de informatie die dit Regionbeschrijft.
GetRegionScans(Matrix)

Retourneert een matrix met RectangleF structuren die dit Region bij benadering bepalen nadat de opgegeven matrixtransformatie is toegepast.
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
InitializeLifetimeService()
Verouderd.

Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren.

(Overgenomen van MarshalByRefObject)
Intersect(GraphicsPath)

Hiermee wordt dit Region bijgewerkt naar het snijpunt van zichzelf met de opgegeven GraphicsPath.
Intersect(Rectangle)

Hiermee wordt dit Region bijgewerkt naar het snijpunt van zichzelf met de opgegeven Rectangle structuur.
Intersect(RectangleF)

Hiermee wordt dit Region bijgewerkt naar het snijpunt van zichzelf met de opgegeven RectangleF structuur.
Intersect(Region)

Hiermee wordt dit Region bijgewerkt naar het snijpunt van zichzelf met de opgegeven Region.
IsEmpty(Graphics)

Test of dit Region een leeg interieur heeft op het opgegeven tekenoppervlak.
IsInfinite(Graphics)

Hiermee wordt getest of dit Region een oneindig interieur heeft op het opgegeven tekenoppervlak.
IsVisible(Int32, Int32, Graphics)

Test of het opgegeven punt zich in dit Region object bevindt wanneer het wordt getekend met behulp van het opgegeven Graphics object.
IsVisible(Int32, Int32, Int32, Int32, Graphics)

Hiermee wordt getest of een deel van de opgegeven rechthoek zich hierin Region bevindt wanneer deze wordt getekend met behulp van de opgegeven Graphics.
IsVisible(Int32, Int32, Int32, Int32)

Hiermee wordt getest of een deel van de opgegeven rechthoek zich in dit Regiongedeelte bevindt.
IsVisible(Point, Graphics)

Test of de opgegeven Point structuur zich hierin Region bevindt wanneer deze wordt getekend met behulp van de opgegeven Graphics.
IsVisible(Point)

Hiermee wordt getest of de opgegeven Point structuur zich in deze Regionstructuur bevindt.
IsVisible(PointF, Graphics)

Test of de opgegeven PointF structuur zich hierin Region bevindt wanneer deze wordt getekend met behulp van de opgegeven Graphics.
IsVisible(PointF)

Hiermee wordt getest of de opgegeven PointF structuur zich in deze Regionstructuur bevindt.
IsVisible(Rectangle, Graphics)

Test of een deel van de opgegeven Rectangle structuur zich hierin Region bevindt wanneer deze wordt getekend met behulp van de opgegeven Graphics.
IsVisible(Rectangle)

Hiermee wordt getest of een deel van de opgegeven Rectangle structuur zich hierin Regionbevindt.
IsVisible(RectangleF, Graphics)

Test of een deel van de opgegeven RectangleF structuur zich hierin Region bevindt wanneer deze wordt getekend met behulp van de opgegeven Graphics.
IsVisible(RectangleF)

Hiermee wordt getest of een deel van de opgegeven RectangleF structuur zich hierin Regionbevindt.
IsVisible(Single, Single, Graphics)

Hiermee wordt getest of het opgegeven punt zich hierin Region bevindt wanneer het wordt getekend met behulp van de opgegeven Graphics.
IsVisible(Single, Single, Single, Single, Graphics)

Hiermee wordt getest of een deel van de opgegeven rechthoek zich hierin Region bevindt wanneer deze wordt getekend met behulp van de opgegeven Graphics.
IsVisible(Single, Single, Single, Single)

Hiermee wordt getest of een deel van de opgegeven rechthoek zich in dit Regiongedeelte bevindt.
IsVisible(Single, Single)

Hiermee wordt getest of het opgegeven punt zich in dit Regionpunt bevindt.
MakeEmpty()

Initialiseert dit Region in een leeg interieur.
MakeInfinite()

Initialiseert dit Region object tot een oneindig interieur.
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
MemberwiseClone(Boolean)

Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object.

(Overgenomen van MarshalByRefObject)
ReleaseHrgn(IntPtr)

Laat de ingang van de Region.
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)
Transform(Matrix)

Transformeert dit Region door de opgegeven Matrix.
Translate(Int32, Int32)

Hiermee worden de coördinaten hiervan Region verschoven met de opgegeven hoeveelheid.
Translate(Single, Single)

Hiermee worden de coördinaten hiervan Region verschoven met de opgegeven hoeveelheid.
Union(GraphicsPath)

Werkt dit Region bij aan de samenvoeging van zichzelf en de opgegeven GraphicsPath.
Union(Rectangle)

Werkt dit Region bij aan de samenvoeging van zichzelf en de opgegeven Rectangle structuur.
Union(RectangleF)

Werkt dit Region bij aan de samenvoeging van zichzelf en de opgegeven RectangleF structuur.
Union(Region)

Werkt dit Region bij aan de samenvoeging van zichzelf en de opgegeven Region.
Xor(GraphicsPath)

Werkt dit Region bij aan de samenvoeging min het snijpunt van zichzelf met de opgegeven GraphicsPath.
Xor(Rectangle)

Hiermee wordt dit Region bijgewerkt naar de samenvoeging min het snijpunt van zichzelf met de opgegeven Rectangle structuur.
Xor(RectangleF)

Hiermee wordt dit Region bijgewerkt naar de samenvoeging min het snijpunt van zichzelf met de opgegeven RectangleF structuur.
Xor(Region)

Werkt dit Region bij aan de samenvoeging min het snijpunt van zichzelf met de opgegeven Region.

Van toepassing op

Zie ook