Region Třída

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v8.0.0

Zdroj:

Region.cs

Popisuje vnitr grafického obrazce složeného z obdélníků a cest. Tato třída se nemůže dě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 model Windows Forms a vyžaduje PaintEventArgse, což je parametr obslužné rutiny Paint události. Příklad kódu ukazuje, jak použít Data z jednoho RegionData objektu Data k nastavení 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 zadané v souřadnicích světa. Na kreslicí ploše je ale její interiér závislý na velikosti a tvaru pixelů, které ji představují. Aplikace může použít oblasti k oříznutí výstupu operací výkresu. Tyto oblasti se nazývají oblasti výřezu. Další informace o použití oblastí pro oříznutí najdete v tématu Postupy: Použití oříznutí s oblastí.

Aplikace může také používat oblasti v operacích testování přístupů, jako je kontrola, jestli bod nebo obdélník protíná oblast. Další informace o používání oblastí pro testování přístupů najdete v tématu Postupy: Použití testování přístupů 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í při kompilaci a výjimky za běhu. Další informace najdete v tématu System.Drawing.Common podporované pouze ve Windows.

Konstruktory

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

Metody

Clone()	Vytvoří přesnou kopii tohoto Regionobjektu .
Complement(GraphicsPath)	Aktualizace, aby obsahoval Region část zadaného GraphicsPath objektu, která se s tímto Regionobjektem neprotíná.
Complement(Rectangle)	Aktualizace, aby obsahoval Region část zadané Rectangle struktury, která se s touto Regionstrukturou neprotíná.
Complement(RectangleF)	Aktualizace, aby obsahoval Region část zadané RectangleF struktury, která se s touto Regionstrukturou neprotíná.
Complement(Region)	Aktualizace, aby obsahoval Region část zadaného Region objektu, která se s tímto Regionobjektem neprotíná.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané tímto Regionnástrojem .
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
Equals(Region, Graphics)	Testuje, zda je zadaný Region objekt shodný s tímto Region na zadané kreslicí ploše.
Exclude(GraphicsPath)	Aktualizace, Region aby obsahovala pouze část jeho interiéru, která se neprotíná se zadaným GraphicsPathobjektem .
Exclude(Rectangle)	Aktualizace, Region aby obsahovala pouze část svého interiéru, která se neprotíná se zadanou Rectangle strukturou.
Exclude(RectangleF)	Aktualizace, Region aby obsahovala pouze část svého interiéru, která se neprotíná se zadanou RectangleF strukturou.
Exclude(Region)	Aktualizace, Region aby obsahovala pouze část jeho interiéru, která se neprotíná se zadaným Regionobjektem .
Finalize()	Umožňuje objektu pokusit se uvolnit prostředky a provést další operace čištění před jeho uvolněním uvolňováním.
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ý ohraničuje tuto Region nakreslené ploše objektuGraphics.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetHrgn(Graphics)	Vrátí popisovač systému Windows v Region zadaném grafickém kontextu.
GetLifetimeService()	Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetRegionData()	Vrátí hodnotu RegionData , která představuje informace, které popisují tento objekt Region.
GetRegionScans(Matrix)	Vrátí pole struktur, které tomuto Region objektu RectangleF po použití zadané transformace matice přiblíží.
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
InitializeLifetimeService()	Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
Intersect(GraphicsPath)	Aktualizace k Region průniku sebe sama se zadaným GraphicsPathparametrem .
Intersect(Rectangle)	Aktualizace k Region průniku sebe sama se zadanou Rectangle strukturou.
Intersect(RectangleF)	Aktualizace k Region průniku sebe sama se zadanou RectangleF strukturou.
Intersect(Region)	Aktualizace k Region průniku sebe sama se zadaným Regionparametrem .
IsEmpty(Graphics)	Testuje, jestli Region má na zadané kreslicí ploše prázdný interiér.
IsInfinite(Graphics)	Testuje, jestli má Region na zadané kreslicí ploše nekonečný vnitřní prostor.
IsVisible(Int32, Int32, Graphics)	Testuje, zda je zadaný bod obsažen v tomto Region objektu při kreslení pomocí zadaného Graphics objektu.
IsVisible(Int32, Int32, Int32, Int32)	Testuje, zda je v tomto Regionobjektu obsažena nějaká část zadaného obdélníku.
IsVisible(Int32, Int32, Int32, Int32, Graphics)	Testuje, zda je v něm Region obsažena nějaká část zadaného obdélníku při vykreslení pomocí zadaného Graphicsobjektu .
IsVisible(Point)	Testuje, zda je zadaná Point struktura obsažena v tomto Regionobjektu .
IsVisible(Point, Graphics)	Testuje, zda je v ní Region obsažena zadaná Point struktura při vykreslení pomocí zadaného Graphicsobjektu .
IsVisible(PointF)	Testuje, zda je zadaná PointF struktura obsažena v tomto Regionobjektu .
IsVisible(PointF, Graphics)	Testuje, zda je v ní Region obsažena zadaná PointF struktura při vykreslení pomocí zadaného Graphicsobjektu .
IsVisible(Rectangle)	Testuje, zda je v tomto Regionobjektu obsažena nějaká část zadané Rectangle struktury.
IsVisible(Rectangle, Graphics)	Testuje, zda je v ní Region obsažena nějaká část zadané Rectangle struktury při vykreslení pomocí zadaného Graphicsobjektu .
IsVisible(RectangleF)	Testuje, zda je v tomto Regionobjektu obsažena nějaká část zadané RectangleF struktury.
IsVisible(RectangleF, Graphics)	Testuje, zda je v ní Region obsažena nějaká část zadané RectangleF struktury při vykreslení pomocí zadaného Graphicsobjektu .
IsVisible(Single, Single)	Testuje, zda je zadaný bod obsažen v tomto Region.
IsVisible(Single, Single, Graphics)	Testuje, zda je zadaný bod obsažen v tomto Region objektu při vykreslení pomocí zadaného Graphicsobjektu .
IsVisible(Single, Single, Single, Single)	Testuje, zda je v tomto Regionobjektu obsažena nějaká část zadaného obdélníku.
IsVisible(Single, Single, Single, Single, Graphics)	Testuje, zda je v něm Region obsažena nějaká část zadaného obdélníku při vykreslení pomocí zadaného Graphicsobjektu .
MakeEmpty()	Inicializuje ho 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 Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (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 ho Region pomocí zadaného Matrixobjektu .
Translate(Int32, Int32)	Odsadí souřadnice o Region zadanou hodnotu.
Translate(Single, Single)	Odsadí souřadnice o Region zadanou hodnotu.
Union(GraphicsPath)	Aktualizace k Region sjednocení sebe sama a zadaného GraphicsPath.
Union(Rectangle)	Aktualizace k Region sjednocení sebe sama a zadané Rectangle struktury.
Union(RectangleF)	Aktualizace k Region sjednocení sebe sama a zadané RectangleF struktury.
Union(Region)	Aktualizace k Region sjednocení sebe sama a zadaného Region.
Xor(GraphicsPath)	Aktualizace do Region sjednocení minus průnik sebe sama se zadaným GraphicsPath.
Xor(Rectangle)	Aktualizace toto Region sjednocení minus průnik sebe sama se zadanou Rectangle strukturou.
Xor(RectangleF)	Aktualizace toto Region sjednocení minus průnik sebe sama se zadanou RectangleF strukturou.
Xor(Region)	Aktualizace do Region sjednocení minus průnik sebe sama se zadaným Region.

Viz také

• Rectangle
• GraphicsPath
• Použití oblastí