Region Klasa

Definicja

Przestrzeń nazw:

System.Drawing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Źródło:

Region.cs

Opisuje wnętrze kształtu grafiki składającego się z prostokątów i ścieżek. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

MarshalByRefObject

Region

Implementuje

IDisposable

Przykłady

Poniższy przykład kodu jest przeznaczony do użycia z Windows Forms i wymaga PaintEventArgseparametru Paint programu obsługi zdarzeń. W przykładzie kodu pokazano, jak użyć Data elementu z jednego RegionData obiektu, aby ustawić Data dla innego RegionDataobiektu .

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

Uwagi

Region jest skalowalny, ponieważ jego współrzędne są określone we współrzędnych świata. Na powierzchni rysunku jego wnętrze zależy jednak od rozmiaru i kształtu pikseli reprezentujących go. Aplikacja może używać regionów do przycinania danych wyjściowych operacji rysunkowych. Te regiony są nazywane regionami wycinków. Aby uzyskać więcej informacji na temat używania regionów do przycinania, zobacz How to: Use Clipping with a Region (Instrukcje: używanie przycinania z regionem).

Aplikacja może również używać regionów w operacjach testowania trafień, takich jak sprawdzanie, czy punkt lub prostokąt przecina region. Aby uzyskać więcej informacji na temat używania regionów do testowania trafień, zobacz How to: Use Hit Testing with a Region (Instrukcje: używanie testowania trafień w regionie).

Aplikacja może wypełnić region przy użyciu Graphics.FillRegion metody i Brush obiektu.

Uwaga

W programach .NET 6 i nowszych pakiet System.Drawing.Common, który zawiera ten typ, jest obsługiwany tylko w systemach operacyjnych Windows. Użycie tego typu w aplikacjach międzyplatformowych powoduje ostrzeżenia w czasie kompilacji i wyjątki czasu wykonywania. Aby uzyskać więcej informacji, zobacz System.Drawing.Common only supported on Windows (Obsługiwane tylko w systemie Windows).

Konstruktory

Region()	Inicjuje nowy Regionelement .
Region(GraphicsPath)	Inicjuje nowy Region element o określonej wartości GraphicsPath.
Region(Rectangle)	Inicjuje nową Region z określonej Rectangle struktury.
Region(RectangleF)	Inicjuje nową Region z określonej RectangleF struktury.
Region(RegionData)	Inicjuje nowe Region dane z określonych danych.

Metody

Clone()	Tworzy dokładną kopię tego elementu Region.
Complement(GraphicsPath)	Aktualizacje zawierać Region część określonego GraphicsPath elementu, która nie przecina się z tym Regionelementem .
Complement(Rectangle)	Aktualizacje toRegion, aby zawierać część określonej Rectangle struktury, która nie przecina się z tym Regionelementem .
Complement(RectangleF)	Aktualizacje toRegion, aby zawierać część określonej RectangleF struktury, która nie przecina się z tym Regionelementem .
Complement(Region)	Aktualizacje zawierać Region część określonego Region elementu, która nie przecina się z tym Regionelementem .
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszystkie zasoby używane przez ten Regionprogram .
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Equals(Region, Graphics)	Sprawdza, czy określona wartość Region jest identyczna Region z tą na określonej powierzchni rysunku.
Exclude(GraphicsPath)	Aktualizacje zawierać Region tylko część jego wnętrza, która nie przecina się z określonym GraphicsPath.
Exclude(Rectangle)	Aktualizacje zawierać Region tylko część jego wnętrza, która nie przecina się z określoną Rectangle strukturą.
Exclude(RectangleF)	Aktualizacje zawierać Region tylko część jego wnętrza, która nie przecina się z określoną RectangleF strukturą.
Exclude(Region)	Aktualizacje zawierać Region tylko część jego wnętrza, która nie przecina się z określonym Region.
Finalize()	Umożliwia obiektowi próbę zwolnienia zasobów i wykonania innych operacji oczyszczania przed odzyskaniem przez odzyskiwanie pamięci.
FromHrgn(IntPtr)	Inicjuje nową Region z uchwytu do określonego istniejącego regionu GDI.
GetBounds(Graphics)	RectangleF Pobiera strukturę reprezentującą prostokąt, który wiąże tę Region strukturę na powierzchni rysunku Graphics obiektu.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetHrgn(Graphics)	Zwraca do tego Region uchwyt systemu Windows w określonym kontekście graficznym.
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetRegionData()	Zwraca element RegionData reprezentujący informacje opisujące ten Regionelement .
GetRegionScans(Matrix)	Zwraca tablicę struktur przybliżonych RectangleF po Region zastosowaniu określonej transformacji macierzy.
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
Intersect(GraphicsPath)	Aktualizacje to Region do skrzyżowania siebie z określonym GraphicsPath.
Intersect(Rectangle)	Aktualizacje to Region do przecięcia się z określoną Rectangle strukturą.
Intersect(RectangleF)	Aktualizacje to Region do przecięcia się z określoną RectangleF strukturą.
Intersect(Region)	Aktualizacje to Region do skrzyżowania siebie z określonym Region.
IsEmpty(Graphics)	Sprawdza, czy ma puste Region wnętrze na określonej powierzchni rysunku.
IsInfinite(Graphics)	Sprawdza, czy ma to Region nieskończone wnętrze na określonej powierzchni rysunkowej.
IsVisible(Int32, Int32, Graphics)	Sprawdza, czy określony punkt znajduje się w tym Region obiekcie podczas narysowanego przy użyciu określonego Graphics obiektu.
IsVisible(Int32, Int32, Int32, Int32)	Sprawdza, czy jakakolwiek część określonego prostokąta jest zawarta w tym Regionelemecie .
IsVisible(Int32, Int32, Int32, Int32, Graphics)	Sprawdza, czy jakakolwiek część określonego prostokąta jest zawarta w tym Region przypadku przy użyciu określonego Graphicselementu .
IsVisible(Point)	Sprawdza, czy określona Point struktura jest zawarta w tym Regionobiekcie .
IsVisible(Point, Graphics)	Sprawdza, czy określona Point struktura jest zawarta w ramach tej Region metody przy użyciu określonego Graphicselementu .
IsVisible(PointF)	Sprawdza, czy określona PointF struktura jest zawarta w tym Regionobiekcie .
IsVisible(PointF, Graphics)	Sprawdza, czy określona PointF struktura jest zawarta w ramach tej Region metody przy użyciu określonego Graphicselementu .
IsVisible(Rectangle)	Sprawdza, czy w ramach tej Regionstruktury znajduje się dowolna część określonej Rectangle struktury.
IsVisible(Rectangle, Graphics)	Sprawdza, czy jakakolwiek część określonej Rectangle struktury jest zawarta w tej Region strukturze podczas rysowania przy użyciu określonego Graphicselementu .
IsVisible(RectangleF)	Sprawdza, czy w ramach tej Regionstruktury znajduje się dowolna część określonej RectangleF struktury.
IsVisible(RectangleF, Graphics)	Sprawdza, czy jakakolwiek część określonej RectangleF struktury jest zawarta w tej Region strukturze podczas rysowania przy użyciu określonego Graphicselementu .
IsVisible(Single, Single)	Sprawdza, czy określony punkt znajduje się w tym Regionobiekcie .
IsVisible(Single, Single, Graphics)	Sprawdza, czy określony punkt jest zawarty w tym Region przypadku przy użyciu określonego Graphicselementu .
IsVisible(Single, Single, Single, Single)	Sprawdza, czy jakakolwiek część określonego prostokąta jest zawarta w tym Regionelemecie .
IsVisible(Single, Single, Single, Single, Graphics)	Sprawdza, czy jakakolwiek część określonego prostokąta jest zawarta w tym Region przypadku przy użyciu określonego Graphicselementu .
MakeEmpty()	Inicjuje to Region do pustego wnętrza.
MakeInfinite()	Inicjuje ten Region obiekt do nieskończonego wnętrza.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
ReleaseHrgn(IntPtr)	Zwalnia uchwyt .Region
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
Transform(Matrix)	Przekształca to Region przez określony Matrixelement .
Translate(Int32, Int32)	Przesunięcie współrzędnych tej Region wartości przez określoną kwotę.
Translate(Single, Single)	Przesunięcie współrzędnych tej Region wartości przez określoną kwotę.
Union(GraphicsPath)	Aktualizacje to Region do samego związku i określonego GraphicsPath.
Union(Rectangle)	Aktualizacje to Region do samej unii i określonej Rectangle struktury.
Union(RectangleF)	Aktualizacje to Region do samej unii i określonej RectangleF struktury.
Union(Region)	Aktualizacje to Region do samego związku i określonego Region.
Xor(GraphicsPath)	Aktualizacje to Region do unii minus skrzyżowanie siebie z określonym GraphicsPath.
Xor(Rectangle)	Aktualizacje to Region do unii minus skrzyżowanie siebie z określoną Rectangle strukturą.
Xor(RectangleF)	Aktualizacje to Region do unii minus skrzyżowanie siebie z określoną RectangleF strukturą.
Xor(Region)	Aktualizacje to Region do unii minus skrzyżowanie siebie z określonym Region.

Zobacz też

• Rectangle
• GraphicsPath
• Używanie regionów