Region Třída

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v9.0.0-preview.5.24306.5

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 objektu RegionData k nastavení 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 soblasti .

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í metody Graphics.FillRegion a objektu Brush.

Poznámka

V .NET 6 a novějších verzích je balíček System.Drawing.Common, který zahrnuje 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 v systému Windows.

Konstruktory

Region()	Inicializuje nový Region.
Region(GraphicsPath)	Inicializuje nový Region se zadaným GraphicsPath.
Region(Rectangle)	Inicializuje novou Region ze zadané struktury Rectangle.
Region(RectangleF)	Inicializuje novou Region ze zadané struktury RectangleF.
Region(RegionData)	Inicializuje nový Region ze zadaných dat.

Metody

Clone()	Vytvoří přesnou kopii tohoto Region.
Complement(GraphicsPath)	Aktualizuje tuto Region tak, aby obsahovala část zadaného GraphicsPath, která se s tímto Regionneprotíná .
Complement(Rectangle)	Aktualizuje tuto Region tak, aby obsahovala část zadané struktury Rectangle, která se neprotíná s touto Region.
Complement(RectangleF)	Aktualizuje tuto Region tak, aby obsahovala část zadané struktury RectangleF, která se neprotíná s touto Region.
Complement(Region)	Aktualizuje tuto Region tak, aby obsahovala část zadaného Region, která se s tímto Regionneprotíná .
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané tímto Region.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
Equals(Region, Graphics)	Testuje, zda je zadaná Region stejná jako tato Region na zadané ploše výkresu.
Exclude(GraphicsPath)	Aktualizuje tuto Region tak, aby obsahovala pouze část jejího interiéru, která se neprotíná se zadanými GraphicsPath.
Exclude(Rectangle)	Aktualizuje tuto Region tak, aby obsahovala pouze část jejího interiéru, která se neprotíná se zadanou strukturou Rectangle.
Exclude(RectangleF)	Aktualizuje tuto Region tak, aby obsahovala pouze část jejího interiéru, která se neprotíná se zadanou strukturou RectangleF.
Exclude(Region)	Aktualizuje tuto Region tak, aby obsahovala pouze část jejího interiéru, která se neprotíná se zadanými 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 novou Region z popisovače do zadané existující oblasti GDI.
GetBounds(Graphics)	Získá RectangleF strukturu, která představuje obdélník, který ohraničuje tento Region na kreslicí plochu Graphics objektu.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetHrgn(Graphics)	Vrátí popisovač Windows k tomuto Region v zadaném grafickém kontextu.
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetRegionData()	Vrátí RegionData, který představuje informace, které popisují tento Region.
GetRegionScans(Matrix)	Vrátí matici RectangleF struktur, které tuto Region po použití zadané transformace matice.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
Intersect(GraphicsPath)	Aktualizuje tento Region na průsečík sebe sama se zadaným GraphicsPath.
Intersect(Rectangle)	Aktualizuje tento Region na průsečík sebe sama se zadanou strukturou Rectangle.
Intersect(RectangleF)	Aktualizuje tento Region na průsečík sebe sama se zadanou strukturou RectangleF.
Intersect(Region)	Aktualizuje tento Region na průsečík sebe sama se zadaným Region.
IsEmpty(Graphics)	Testuje, zda má tato Region prázdný interiér na zadané ploše výkresu.
IsInfinite(Graphics)	Testuje, zda má tato Region nekonečný interiér na zadané kreslicí ploše.
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)	Testuje, zda některá část zadaného obdélníku je obsažena v tomto Region.
IsVisible(Int32, Int32, Int32, Int32, Graphics)	Testuje, zda je některá část zadaného obdélníku obsažena v tomto Region při kreslení pomocí zadané Graphics.
IsVisible(Point)	Testuje, zda je zadaná Point struktura 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(PointF)	Testuje, zda je zadaná PointF 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(Rectangle)	Testuje, zda je v této Regionobsažena jakákoli část zadané struktury Rectangle .
IsVisible(Rectangle, Graphics)	Testuje, zda je některá část zadané struktury Rectangle obsažena v této Region při vykreslení pomocí zadané Graphics.
IsVisible(RectangleF)	Testuje, zda je v této Regionobsažena jakákoli část zadané struktury RectangleF .
IsVisible(RectangleF, Graphics)	Testuje, zda je některá část zadané struktury RectangleF obsažena v této Region při vykreslení pomocí zadané Graphics.
IsVisible(Single, Single)	Testuje, zda zadaný bod je obsažen v tomto Region.
IsVisible(Single, Single, Graphics)	Testuje, zda je zadaný bod obsažen v tomto Region při vykreslení pomocí zadané 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, Single, Single, Graphics)	Testuje, zda je některá část zadaného obdélníku obsažena v tomto Region při kreslení pomocí zadané Graphics.
MakeEmpty()	Inicializuje tuto Region do prázdného interiéru.
MakeInfinite()	Inicializuje tento Region objekt do nekonečného interiéru.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního objektu MarshalByRefObject. (Zděděno od MarshalByRefObject)
ReleaseHrgn(IntPtr)	Uvolní popisovač Region.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
Transform(Matrix)	Transformuje tento Region zadaným Matrix.
Translate(Int32, Int32)	Posune souřadnice tohoto Region o zadanou částku.
Translate(Single, Single)	Posune souřadnice tohoto Region o zadanou částku.
Union(GraphicsPath)	Aktualizuje tento Region na sjednocování samotného a zadaného GraphicsPath.
Union(Rectangle)	Aktualizuje tento Region na sjednocování sebe sama a na zadanou strukturu Rectangle.
Union(RectangleF)	Aktualizuje tento Region na sjednocování sebe sama a na zadanou strukturu RectangleF.
Union(Region)	Aktualizuje tento Region na sjednocování samotného a zadaného Region.
Xor(GraphicsPath)	Aktualizuje tuto Region na sjednocování minus průnik sebe sama se zadaným GraphicsPath.
Xor(Rectangle)	Aktualizuje tento Region na sjednocování minus průnik sebe sama se zadanou strukturou Rectangle.
Xor(RectangleF)	Aktualizuje tento Region na sjednocování minus průnik sebe sama se zadanou strukturou RectangleF.
Xor(Region)	Aktualizuje tuto Region na sjednocování minus průnik sebe sama se zadaným Region.

Viz také

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