Region クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
四角形とパスで構成されるグラフィックス図形の内部について説明します。 このクラスは継承できません。
public ref class Region sealed : MarshalByRefObject, IDisposablepublic sealed class Region : MarshalByRefObject, IDisposable[System.Runtime.InteropServices.ComVisible(false)]
public sealed class Region : MarshalByRefObject, IDisposabletype Region = class
inherit MarshalByRefObject
interface IDisposable[<System.Runtime.InteropServices.ComVisible(false)>]
type Region = class
inherit MarshalByRefObject
interface IDisposablePublic NotInheritable Class Region
Inherits MarshalByRefObject
Implements IDisposable- 継承
- 属性
- 実装
例
次のコード例は Windows フォームで使用できるように設計されており、Paint イベント ハンドラーのパラメーターである PaintEventArgseが必要です。 このコード例では、ある RegionData オブジェクトの Data を使用して、別の RegionDataの Data を設定する方法を示します。
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
注釈
リージョンの座標はワールド座標で指定されているため、スケーラブルです。 ただし、描画サーフェイスでは、その内部は、それを表すピクセルのサイズと形状に依存します。 アプリケーションでは、領域を使用して描画操作の出力をクリップできます。 これらの領域はクリッピング領域と呼ばれます。 領域をクリッピングに使用する方法の詳細については、「方法: 領域でクリッピングを使用する」を参照してください。
アプリケーションでは、ポイントまたは四角形が領域と交差するかどうかを確認するなど、ヒット テスト操作で領域を使用することもできます。 ヒット テストにリージョンを使用する方法の詳細については、「方法: リージョンでヒット テストを使用する」を参照してください。
アプリケーションは、Graphics.FillRegion メソッドと Brush オブジェクトを使用して領域を塗りつぶすことができます。
手記
.NET 6 以降のバージョンでは、この種類を含む System.Drawing.Common パッケージは、Windows オペレーティング システムでのみサポートされています。 クロスプラットフォーム アプリでこの種類を使用すると、コンパイル時の警告と実行時の例外が発生します。 詳細については、「System.Drawing.Common が Windowsでのみサポートされる」を参照してください。
コンストラクター
| Region() |
新しい Regionを初期化します。 |
| Region(GraphicsPath) |
指定した GraphicsPathを使用して新しい Region を初期化します。 |
| Region(Rectangle) | |
| Region(RectangleF) |
指定した RectangleF 構造体から新しい Region を初期化します。 |
| Region(RegionData) |
指定したデータから新しい Region を初期化します。 |
メソッド
適用対象
こちらもご覧ください
- Rectangle
- GraphicsPath
- リージョンの使用 の
.NET