Region Třída

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Zdroj:

Region.cs

Popisuje interiér grafického obrazce složeného z obdélníků a cest. Tuto třídu nelze zdědit.

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

Dědičnost

Object

MarshalByRefObject

Region

Implementuje

IDisposable

Příklady

Následující příklad kódu je určený pro použití s Windows Forms a vyžaduje PaintEventArgse, což je parametr obslužné rutiny události Paint. Příklad kódu ukazuje, jak použít Data z jednoho RegionData objektu nastavit Data pro jiný 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

Poznámky

Oblast je škálovatelná, protože její souřadnice jsou zadány ve světových souřadnicích. Na kreslicí ploše je ale jeho interiér závislý na velikosti a tvaru pixelů, které ho představují. Aplikace může použít oblasti k oříznutí výstupu operací kreslení. Tyto oblasti se nazývají oblasti výřezu. Další informace o použití oblastí k výřezu najdete v tématu Postupy: Použití výřezu s oblastí.

Aplikace může také použít oblasti v operacích testování hit-testování, jako je například kontrola, jestli bod nebo obdélník protíná oblast. Další informace o používání oblastí pro testování hit-testování naleznete v tématu Postupy: Použití testování hitů s oblastí.

Aplikace může vyplnit oblast pomocí Graphics.FillRegion metody a objektu Brush .

Poznámka

V .NET 6 a novějších verzích je balíček System.Drawing.Common, který obsahuje tento typ, podporován pouze v operačních systémech Windows. Použití tohoto typu v multiplatformních aplikacích způsobuje upozornění v době kompilace a výjimky za běhu. Další informace naleznete v tématu System.Drawing.Common podporován pouze ve Windows.

Konstruktory

Name	Description
Region()	Inicializuje nový Region.
Region(GraphicsPath)	Inicializuje nový Region pomocí zadaného GraphicsPath.
Region(Rectangle)	Inicializuje novou Region ze zadané Rectangle struktury.
Region(RectangleF)	Inicializuje novou Region ze zadané RectangleF struktury.
Region(RegionData)	Inicializuje nový Region ze zadaných dat.

Metody

Name	Description
Clone()	Vytvoří přesnou kopii tohoto Regionsouboru .
Complement(GraphicsPath)	Aktualizuje tuto možnost Region tak, aby obsahovala část zadaného GraphicsPath objektu, který se s tímto Regionneprotíná .
Complement(Rectangle)	Aktualizuje to Region tak, aby obsahovala část zadané Rectangle struktury, která se tímto neprotíná Region.
Complement(RectangleF)	Aktualizuje to Region tak, aby obsahovala část zadané RectangleF struktury, která se tímto neprotíná Region.
Complement(Region)	Aktualizuje tuto možnost Region tak, aby obsahovala část zadaného Region objektu, který se s tímto Regionneprotíná .
Dispose()	Uvolní všechny prostředky používané tímto Regionnástrojem .
Equals(Region, Graphics)	Testuje, zda je zadaný Region identický s tímto Region na zadané ploše výkresu.
Exclude(GraphicsPath)	Aktualizuje to Region tak, aby obsahoval pouze část jeho interiéru, která se neprotíná se zadaným GraphicsPath.
Exclude(Rectangle)	Aktualizuje tuto možnost Region tak, aby obsahovala pouze část jejího interiéru, která se neprotíná se zadanou Rectangle strukturou.
Exclude(RectangleF)	Aktualizuje tuto možnost Region tak, aby obsahovala pouze část jejího interiéru, která se neprotíná se zadanou RectangleF strukturou.
Exclude(Region)	Aktualizuje to Region tak, aby obsahoval pouze část jeho interiéru, která se neprotíná se zadaným Region.
Finalize()	Umožňuje objektu pokusit se uvolnit prostředky a provést další operace čištění před uvolněním paměti.
FromHrgn(IntPtr)	Inicializuje nový Region z popisovače do zadané existující oblasti GDI.
GetBounds(Graphics)	RectangleF Získá strukturu, která představuje obdélník, který ho ohraničuje Region na kreslicí ploše objektuGraphics.
GetHrgn(Graphics)	Vrátí popisovač Windows v Region zadaném grafickém kontextu.
GetRegionData()	Vrátí hodnotu RegionData , která představuje informace, které tento Regionpopis .
GetRegionScans(Matrix)	Vrátí matici RectangleF struktur, které se blíží této Region po použití zadané transformace matice.
Intersect(GraphicsPath)	Aktualizuje to Region na průsečík sebe sama se zadaným GraphicsPath.
Intersect(Rectangle)	Aktualizuje to Region na průsečík sebe sama se zadanou Rectangle strukturou.
Intersect(RectangleF)	Aktualizuje to Region na průsečík sebe sama se zadanou RectangleF strukturou.
Intersect(Region)	Aktualizuje to Region na průsečík sebe sama se zadaným Region.
IsEmpty(Graphics)	Testuje, zda má na Region zadané ploše výkresu prázdný interiér.
IsInfinite(Graphics)	Testuje, zda má na Region zadané ploše výkresu nekonečný interiér.
IsVisible(Int32, Int32, Graphics)	Testuje, zda je zadaný bod obsažen v tomto Region objektu při vykreslení pomocí zadaného Graphics objektu.
IsVisible(Int32, Int32, Int32, Int32, Graphics)	Testuje, zda je některá část zadaného obdélníku obsažena v této Region části při nakreslení pomocí zadaného Graphics.
IsVisible(Int32, Int32, Int32, Int32)	Testuje, zda některá část zadaného obdélníku je obsažena v tomto Region.
IsVisible(Point, Graphics)	Testuje, zda je zadaná Point struktura obsažena v této Region při vykreslení pomocí zadané Graphics.
IsVisible(Point)	Testuje, zda je zadaná Point struktura obsažena v tomto Region.
IsVisible(PointF, Graphics)	Testuje, zda je zadaná PointF struktura obsažena v této Region při vykreslení pomocí zadané Graphics.
IsVisible(PointF)	Testuje, zda je zadaná PointF struktura obsažena v tomto Region.
IsVisible(Rectangle, Graphics)	Testuje, zda je některá část zadané Rectangle struktury obsažena v této Region části při vykreslení pomocí zadané Graphics.
IsVisible(Rectangle)	Testuje, zda je v této Regiončásti zadané struktury obsažena jakákoli část zadané Rectangle struktury .
IsVisible(RectangleF, Graphics)	Testuje, zda je některá část zadané RectangleF struktury obsažena v této Region části při vykreslení pomocí zadané Graphics.
IsVisible(RectangleF)	Testuje, zda je v této Regiončásti zadané struktury obsažena jakákoli část zadané RectangleF struktury .
IsVisible(Single, Single, Graphics)	Testuje, zda je zadaný bod obsažen v tomto Region při vykreslení pomocí zadaného Graphics.
IsVisible(Single, Single, Single, Single, Graphics)	Testuje, zda je některá část zadaného obdélníku obsažena v této Region části při nakreslení pomocí zadaného Graphics.
IsVisible(Single, Single, Single, Single)	Testuje, zda některá část zadaného obdélníku je obsažena v tomto Region.
IsVisible(Single, Single)	Testuje, zda je zadaný bod obsažen v tomto Region.
MakeEmpty()	Inicializuje to Region do prázdného interiéru.
MakeInfinite()	Inicializuje tento Region objekt do nekonečného interiéru.
ReleaseHrgn(IntPtr)	Uvolní popisovač Region.
Transform(Matrix)	Transformuje to Region zadaným Matrix.
Translate(Int32, Int32)	Posune souřadnice této Region hodnoty o zadanou částku.
Translate(Single, Single)	Posune souřadnice této Region hodnoty o zadanou částku.
Union(GraphicsPath)	Aktualizuje to Region na sjednocování samotného a zadaného GraphicsPath.
Union(Rectangle)	Aktualizuje to Region na sjednocování sebe sama a zadanou Rectangle strukturu.
Union(RectangleF)	Aktualizuje to Region na sjednocování sebe sama a zadanou RectangleF strukturu.
Union(Region)	Aktualizuje to Region na sjednocování samotného a zadaného Region.
Xor(GraphicsPath)	Aktualizuje to Region na sjednocení minus průnik sebe sama se zadaným GraphicsPath.
Xor(Rectangle)	Aktualizuje to Region na sjednocení minus průnik sebe sama se zadanou Rectangle strukturou.
Xor(RectangleF)	Aktualizuje to Region na sjednocení minus průnik sebe sama se zadanou RectangleF strukturou.
Xor(Region)	Aktualizuje to Region na sjednocení minus průnik sebe sama se zadaným Region.

Viz také

• Rectangle
• GraphicsPath
• Používání oblastí