Region Region Region Region Class

定義

四角形とパスで構成されるグラフィックス形状の内部を示します。Describes the interior of a graphics shape composed of rectangles and paths. このクラスは継承できません。This class cannot be inherited.

public ref class Region sealed : MarshalByRefObject, IDisposable
[System.Runtime.InteropServices.ComVisible(false)]
public sealed class Region : MarshalByRefObject, IDisposable
type Region = class
    inherit MarshalByRefObject
    interface IDisposable
Public NotInheritable Class Region
Inherits MarshalByRefObject
Implements IDisposable
継承
属性
実装

次のコード例は、Windows フォームで使用するように設計さPaintEventArgsれています。これはPaint 、イベントハンドラーのパラメーターであるを必要eとします。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. このコード例では、1つData RegionDataのオブジェクトからを使用しDataて、 RegionDataを別のオブジェクトに設定する方法を示します。The code example demonstrates how to use the Data from one RegionData object to set the Data for another 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

注釈

領域は、その座標がワールド座標で指定されているため、スケーラブルです。A region is scalable because its coordinates are specified in world coordinates. ただし、描画サーフェイスでは、その内部は、それを表すピクセルのサイズと形状に依存します。On a drawing surface, however, its interior is dependent on the size and shape of the pixels representing it. アプリケーションでは、領域を使用して描画操作の出力をクリップできます。An application can use regions to clip the output of drawing operations. これらの領域をクリッピング領域と呼びます。These regions are called clipping regions. 領域を使用したクリッピングの詳細については、「方法:領域でクリッピングを使用します。For more information on using regions for clipping, see How to: Use Clipping with a Region.

アプリケーションでは、ポイントまたは四角形が領域と交差するかどうかの確認など、ヒットテスト操作で領域を使用することもできます。An application can also use regions in hit-testing operations, such as checking whether a point or a rectangle intersects a region. ヒットテストにリージョンを使用する方法の詳細については、「」を参照してください。領域でヒットテストを使用します。For more information on using regions for hit-testing, see How to: Use Hit Testing with a Region.

アプリケーションでは、 Graphics.FillRegionメソッドBrushとオブジェクトを使用して領域を埋めることができます。An application can fill a region by using the Graphics.FillRegion method and a Brush object.

コンストラクター

Region() Region() Region() Region()

新しい Region を初期化します。Initializes a new Region.

Region(GraphicsPath) Region(GraphicsPath) Region(GraphicsPath) Region(GraphicsPath)

指定した GraphicsPath で新しい Region を初期化します。Initializes a new Region with the specified GraphicsPath.

Region(Rectangle) Region(Rectangle) Region(Rectangle) Region(Rectangle)

指定の Region 構造体から新しい Rectangle を初期化します。Initializes a new Region from the specified Rectangle structure.

Region(RectangleF) Region(RectangleF) Region(RectangleF) Region(RectangleF)

指定の Region 構造体から新しい RectangleF を初期化します。Initializes a new Region from the specified RectangleF structure.

Region(RegionData) Region(RegionData) Region(RegionData) Region(RegionData)

指定したデータから新しい Region を初期化します。Initializes a new Region from the specified data.

メソッド

Clone() Clone() Clone() Clone()

この Region の同一コピーを作成します。Creates an exact copy of this Region.

Complement(GraphicsPath) Complement(GraphicsPath) Complement(GraphicsPath) Complement(GraphicsPath)

この Region と交差しない指定の GraphicsPath の部分が含まれるように、この Region を更新します。Updates this Region to contain the portion of the specified GraphicsPath that does not intersect with this Region.

Complement(Rectangle) Complement(Rectangle) Complement(Rectangle) Complement(Rectangle)

この Region と交差しない指定の Rectangle 構造体の部分が含まれるように、この Region を更新します。Updates this Region to contain the portion of the specified Rectangle structure that does not intersect with this Region.

Complement(RectangleF) Complement(RectangleF) Complement(RectangleF) Complement(RectangleF)

この Region と交差しない指定の RectangleF 構造体の部分が含まれるように、この Region を更新します。Updates this Region to contain the portion of the specified RectangleF structure that does not intersect with this Region.

Complement(Region) Complement(Region) Complement(Region) Complement(Region)

この Region と交差しない指定の Region の部分が含まれるように、この Region を更新します。Updates this Region to contain the portion of the specified Region that does not intersect with this Region.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

この Region によって使用されているすべてのリソースを解放します。Releases all resources used by this Region.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
Equals(Region, Graphics) Equals(Region, Graphics) Equals(Region, Graphics) Equals(Region, Graphics)

指定の Region が、指定の描画サーフェイス上のこの Region と同一かどうかをテストします。Tests whether the specified Region is identical to this Region on the specified drawing surface.

Exclude(GraphicsPath) Exclude(GraphicsPath) Exclude(GraphicsPath) Exclude(GraphicsPath)

指定の Region と交差しない内部の部分だけが含まれるよう、この GraphicsPath を更新します。Updates this Region to contain only the portion of its interior that does not intersect with the specified GraphicsPath.

Exclude(Rectangle) Exclude(Rectangle) Exclude(Rectangle) Exclude(Rectangle)

指定の Region 構造体と交差しない内部の部分だけが含まれるよう、この Rectangle を更新します。Updates this Region to contain only the portion of its interior that does not intersect with the specified Rectangle structure.

Exclude(RectangleF) Exclude(RectangleF) Exclude(RectangleF) Exclude(RectangleF)

指定の Region 構造体と交差しない内部の部分だけが含まれるよう、この RectangleF を更新します。Updates this Region to contain only the portion of its interior that does not intersect with the specified RectangleF structure.

Exclude(Region) Exclude(Region) Exclude(Region) Exclude(Region)

指定の Region と交差しない内部の部分だけが含まれるよう、この Region を更新します。Updates this Region to contain only the portion of its interior that does not intersect with the specified Region.

Finalize() Finalize() Finalize() Finalize()

オブジェクトが、ガベージ コレクションによって収集される前に、リソースの解放とその他のクリーンアップ操作の実行を試みることができるようにします。Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

FromHrgn(IntPtr) FromHrgn(IntPtr) FromHrgn(IntPtr) FromHrgn(IntPtr)

既存の指定の GDIGDI 領域を識別するハンドルから新しい Region を初期化します。Initializes a new Region from a handle to the specified existing GDIGDI region.

GetBounds(Graphics) GetBounds(Graphics) GetBounds(Graphics) GetBounds(Graphics)

RectangleF オブジェクトの描画サーフェイスのこの Region に外接する四角形を表す Graphics 構造体を取得します。Gets a RectangleF structure that represents a rectangle that bounds this Region on the drawing surface of a Graphics object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetHrgn(Graphics) GetHrgn(Graphics) GetHrgn(Graphics) GetHrgn(Graphics)

この Region を識別する Windows ハンドルを、指定のグラフィックス コンテキストで返します。Returns a Windows handle to this Region in the specified graphics context.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetRegionData() GetRegionData() GetRegionData() GetRegionData()

この RegionData を説明する情報を表す Region を返します。Returns a RegionData that represents the information that describes this Region.

GetRegionScans(Matrix) GetRegionScans(Matrix) GetRegionScans(Matrix) GetRegionScans(Matrix)

指定の行列変換が適用された後にこの RectangleF を近似する Region 構造体の配列を返します。Returns an array of RectangleF structures that approximate this Region after the specified matrix transformation is applied.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
Intersect(GraphicsPath) Intersect(GraphicsPath) Intersect(GraphicsPath) Intersect(GraphicsPath)

この Region をそれ自体と指定の GraphicsPath の交差部分に更新します。Updates this Region to the intersection of itself with the specified GraphicsPath.

Intersect(Rectangle) Intersect(Rectangle) Intersect(Rectangle) Intersect(Rectangle)

この Region をそれ自体と指定の Rectangle 構造体の交差部分に更新します。Updates this Region to the intersection of itself with the specified Rectangle structure.

Intersect(RectangleF) Intersect(RectangleF) Intersect(RectangleF) Intersect(RectangleF)

この Region をそれ自体と指定の RectangleF 構造体の交差部分に更新します。Updates this Region to the intersection of itself with the specified RectangleF structure.

Intersect(Region) Intersect(Region) Intersect(Region) Intersect(Region)

この Region をそれ自体と指定の Region の交差部分に更新します。Updates this Region to the intersection of itself with the specified Region.

IsEmpty(Graphics) IsEmpty(Graphics) IsEmpty(Graphics) IsEmpty(Graphics)

この Region の内部が指定の描画サーフェイスで空になるかどうかをテストします。Tests whether this Region has an empty interior on the specified drawing surface.

IsInfinite(Graphics) IsInfinite(Graphics) IsInfinite(Graphics) IsInfinite(Graphics)

この Region の内部が指定の描画サーフェイスで無限になるかどうかをテストします。Tests whether this Region has an infinite interior on the specified drawing surface.

IsVisible(Int32, Int32, Graphics) IsVisible(Int32, Int32, Graphics) IsVisible(Int32, Int32, Graphics) IsVisible(Int32, Int32, Graphics)

指定の Region オブジェクトを使用して描画した場合に、指定の点がこの Graphics オブジェクト内に含まれるかどうかをテストします。Tests whether the specified point is contained within this Region object when drawn using the specified Graphics object.

IsVisible(Int32, Int32, Int32, Int32) IsVisible(Int32, Int32, Int32, Int32) IsVisible(Int32, Int32, Int32, Int32) IsVisible(Int32, Int32, Int32, Int32)

指定の四角形の一部が、この Region に含まれているかどうかをテストします。Tests whether any portion of the specified rectangle is contained within this Region.

IsVisible(Int32, Int32, Int32, Int32, Graphics) IsVisible(Int32, Int32, Int32, Int32, Graphics) IsVisible(Int32, Int32, Int32, Int32, Graphics) IsVisible(Int32, Int32, Int32, Int32, Graphics)

指定の Region オブジェクトを使用して描画した場合に、指定の四角形の一部がこの Graphics に含まれるかどうかをテストします。Tests whether any portion of the specified rectangle is contained within this Region when drawn using the specified Graphics.

IsVisible(Point) IsVisible(Point) IsVisible(Point) IsVisible(Point)

指定の Point 構造体がこの Region に含まれているかどうかをテストします。Tests whether the specified Point structure is contained within this Region.

IsVisible(Point, Graphics) IsVisible(Point, Graphics) IsVisible(Point, Graphics) IsVisible(Point, Graphics)

指定の Point を使用して描画した場合に、指定の Region 構造体がこの Graphics に含まれるかどうかをテストします。Tests whether the specified Point structure is contained within this Region when drawn using the specified Graphics.

IsVisible(PointF) IsVisible(PointF) IsVisible(PointF) IsVisible(PointF)

指定の PointF 構造体がこの Region に含まれているかどうかをテストします。Tests whether the specified PointF structure is contained within this Region.

IsVisible(PointF, Graphics) IsVisible(PointF, Graphics) IsVisible(PointF, Graphics) IsVisible(PointF, Graphics)

指定の PointF を使用して描画した場合に、指定の Region 構造体がこの Graphics に含まれるかどうかをテストします。Tests whether the specified PointF structure is contained within this Region when drawn using the specified Graphics.

IsVisible(Rectangle) IsVisible(Rectangle) IsVisible(Rectangle) IsVisible(Rectangle)

指定の Rectangle 構造体の一部が、この Region に含まれているかどうかをテストします。Tests whether any portion of the specified Rectangle structure is contained within this Region.

IsVisible(Rectangle, Graphics) IsVisible(Rectangle, Graphics) IsVisible(Rectangle, Graphics) IsVisible(Rectangle, Graphics)

指定の Rectangle を使用して描画した場合に、指定の Region 構造体の一部がこの Graphics に含まれるかどうかをテストします。Tests whether any portion of the specified Rectangle structure is contained within this Region when drawn using the specified Graphics.

IsVisible(RectangleF) IsVisible(RectangleF) IsVisible(RectangleF) IsVisible(RectangleF)

指定の RectangleF 構造体の一部が、この Region に含まれているかどうかをテストします。Tests whether any portion of the specified RectangleF structure is contained within this Region.

IsVisible(RectangleF, Graphics) IsVisible(RectangleF, Graphics) IsVisible(RectangleF, Graphics) IsVisible(RectangleF, Graphics)

指定の RectangleF を使用して描画した場合に、指定の Region 構造体の一部がこの Graphics に含まれるかどうかをテストします。Tests whether any portion of the specified RectangleF structure is contained within this Region when drawn using the specified Graphics.

IsVisible(Single, Single) IsVisible(Single, Single) IsVisible(Single, Single) IsVisible(Single, Single)

指定の点がこの Region に含まれているかどうかをテストします。Tests whether the specified point is contained within this Region.

IsVisible(Single, Single, Graphics) IsVisible(Single, Single, Graphics) IsVisible(Single, Single, Graphics) IsVisible(Single, Single, Graphics)

指定の Region を使用して描画した場合に、指定の点がこの Graphics に含まれるかどうかをテストします。Tests whether the specified point is contained within this Region when drawn using the specified Graphics.

IsVisible(Single, Single, Single, Single) IsVisible(Single, Single, Single, Single) IsVisible(Single, Single, Single, Single) IsVisible(Single, Single, Single, Single)

指定の四角形の一部が、この Region に含まれているかどうかをテストします。Tests whether any portion of the specified rectangle is contained within this Region.

IsVisible(Single, Single, Single, Single, Graphics) IsVisible(Single, Single, Single, Single, Graphics) IsVisible(Single, Single, Single, Single, Graphics) IsVisible(Single, Single, Single, Single, Graphics)

指定の Region オブジェクトを使用して描画した場合に、指定の四角形の一部がこの Graphics に含まれるかどうかをテストします。Tests whether any portion of the specified rectangle is contained within this Region when drawn using the specified Graphics.

MakeEmpty() MakeEmpty() MakeEmpty() MakeEmpty()

この Region を初期化して内部を空にします。Initializes this Region to an empty interior.

MakeInfinite() MakeInfinite() MakeInfinite() MakeInfinite()

この Region オブジェクトを初期化して内部を無限にします。Initializes this Region object to an infinite interior.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ReleaseHrgn(IntPtr) ReleaseHrgn(IntPtr) ReleaseHrgn(IntPtr) ReleaseHrgn(IntPtr)

Region のハンドルを解放します。Releases the handle of the Region.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)
Transform(Matrix) Transform(Matrix) Transform(Matrix) Transform(Matrix)

この Region を指定の Matrix で変換します。Transforms this Region by the specified Matrix.

Translate(Int32, Int32) Translate(Int32, Int32) Translate(Int32, Int32) Translate(Int32, Int32)

指定した量でこの Region の座標をオフセットします。Offsets the coordinates of this Region by the specified amount.

Translate(Single, Single) Translate(Single, Single) Translate(Single, Single) Translate(Single, Single)

指定した量でこの Region の座標をオフセットします。Offsets the coordinates of this Region by the specified amount.

Union(GraphicsPath) Union(GraphicsPath) Union(GraphicsPath) Union(GraphicsPath)

この Region を、それ自体と指定の GraphicsPath の和集合に更新します。Updates this Region to the union of itself and the specified GraphicsPath.

Union(Rectangle) Union(Rectangle) Union(Rectangle) Union(Rectangle)

この Region を、それ自体と指定の Rectangle 構造体の和集合に更新します。Updates this Region to the union of itself and the specified Rectangle structure.

Union(RectangleF) Union(RectangleF) Union(RectangleF) Union(RectangleF)

この Region を、それ自体と指定の RectangleF 構造体の和集合に更新します。Updates this Region to the union of itself and the specified RectangleF structure.

Union(Region) Union(Region) Union(Region) Union(Region)

この Region を、それ自体と指定の Region の和集合に更新します。Updates this Region to the union of itself and the specified Region.

Xor(GraphicsPath) Xor(GraphicsPath) Xor(GraphicsPath) Xor(GraphicsPath)

この Region を、それ自体と指定の GraphicsPath の交差部分を差し引いた和集合に更新します。Updates this Region to the union minus the intersection of itself with the specified GraphicsPath.

Xor(Rectangle) Xor(Rectangle) Xor(Rectangle) Xor(Rectangle)

この Region を、それ自体と指定の Rectangle 構造体の交差部分を差し引いた和集合に更新します。Updates this Region to the union minus the intersection of itself with the specified Rectangle structure.

Xor(RectangleF) Xor(RectangleF) Xor(RectangleF) Xor(RectangleF)

この Region を、それ自体と指定の RectangleF 構造体の交差部分を差し引いた和集合に更新します。Updates this Region to the union minus the intersection of itself with the specified RectangleF structure.

Xor(Region) Xor(Region) Xor(Region) Xor(Region)

この Region を、それ自体と指定の Region の交差部分を差し引いた和集合に更新します。Updates this Region to the union minus the intersection of itself with the specified Region.

適用対象

こちらもご覧ください