Rectangle 構造体

定義

名前空間:: System.Drawing

アセンブリ:: System.Drawing.Primitives.dll

アセンブリ:: System.Drawing.dll

アセンブリ:: netstandard.dll

四角形の位置とサイズを表す 4 つの整数を格納します。Stores a set of four integers that represent the location and size of a rectangle.

public value class Rectangle : IEquatable<System::Drawing::Rectangle>

public value class Rectangle

[System.ComponentModel.TypeConverter("System.Drawing.RectangleConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public struct Rectangle : IEquatable<System.Drawing.Rectangle>

public struct Rectangle

public struct Rectangle : IEquatable<System.Drawing.Rectangle>

[System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct Rectangle

type Rectangle = struct

Public Structure Rectangle
Implements IEquatable(Of Rectangle)

Public Structure Rectangle

継承: Object

ValueType
Rectangle

属性: TypeConverterAttribute ComVisibleAttribute SerializableAttribute TypeConverterAttribute

実装: IEquatable<Rectangle>

例

次の例では、左上隅に (10, 10) の四角形を描画します。The following example draws a rectangle with its upper-left corner at (10, 10). 四角形の幅は100、高さは50です。The rectangle has a width of 100 and a height of 50. Pen コンストラクターに渡される2番目の引数は、ペンの幅が5ピクセルであることを示します。The second argument passed to the Pen constructor indicates that the pen width is 5 pixels.

四角形が描画されると、ペンは四角形の境界の中央に配置されます。When the rectangle is drawn, the pen is centered on the rectangle's boundary. ペンの幅は5であるため、四角形の辺は5ピクセル幅で描画されます。これにより、境界自体に1ピクセルが描画され、2ピクセルが内側に描画され、2ピクセルが外側に描画されます。Because the pen width is 5, the sides of the rectangle are drawn 5 pixels wide, such that 1 pixel is drawn on the boundary itself, 2 pixels are drawn on the inside, and 2 pixels are drawn on the outside. ペンの配置の詳細については、「方法: ペンの幅と配置を設定する」を参照してください。For more details on pen alignment, see How to: Set Pen Width and Alignment.

次の図は、結果として得られる四角形を示しています。The following illustration shows the resulting rectangle. 点線は、ペンの幅が1ピクセルの場合に四角形が描画された場所を示しています。The dotted lines show where the rectangle would have been drawn if the pen width had been one pixel. 四角形の左上隅の拡大表示は、太い黒い線がそれらの点線の中央に配置されていることを示しています。The enlarged view of the upper-left corner of the rectangle shows that the thick black lines are centered on those dotted lines.

Pens

この例は、Windows フォームで使用するように設計されており、Paint イベントハンドラーのパラメーターである PaintEventArgseが必要です。The example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler.

Pen blackPen = new Pen(Color.FromArgb(255, 0, 0, 0), 5);
e.Graphics.DrawRectangle(blackPen, 10, 10, 100, 50);

Dim blackPen As New Pen(Color.FromArgb(255, 0, 0, 0), 5)
e.Graphics.DrawRectangle(blackPen, 10, 10, 100, 50)

注釈

四角形は、Location プロパティによって表される Width、Height、左上隅によって定義されます。A rectangle is defined by its Width, Height, and upper-left corner represented by the Location property.

四角形を描画するには、Graphics オブジェクトと Pen オブジェクトが必要です。To draw rectangles, you need a Graphics object and a Pen object. Graphics オブジェクトは、DrawRectangle メソッドを提供し、Pen オブジェクトは、色や幅などの線の機能を格納します。The Graphics object provides the DrawRectangle method, and the Pen object stores features of the line, such as color and width. 四角形が描画される単位は、描画に使用されるグラフィックスオブジェクトの PageUnit および PageScale プロパティによって決定されます。The units the rectangle is drawn in is determined by the PageUnit and PageScale properties of the graphics object used for drawing. 既定の単位はピクセルです。The default unit is pixels.

色で塗りつぶされた Rectangle を描画するには、Graphics オブジェクトと、SolidBrush や LinearGradientBrushなどの Brush から派生したオブジェクトが必要です。To draw a Rectangle filled with color, you need a Graphics object and an object derived from Brush such as SolidBrush or LinearGradientBrush. Graphics オブジェクトは、FillRectangle メソッドを提供し、Brush オブジェクトは色と塗りつぶしの情報を提供します。The Graphics object provides the FillRectangle method and the Brush object provides the color and fill information.

より高度な図形の場合は、Region オブジェクトを使用します。For more advanced shapes, use a Region object.

コンストラクター

Rectangle(Int32, Int32, Int32, Int32)	指定した位置とサイズで、Rectangle クラスの新しいインスタンスを初期化します。Initializes a new instance of the Rectangle class with the specified location and size.
Rectangle(Point, Size)	指定した位置とサイズで、Rectangle クラスの新しいインスタンスを初期化します。Initializes a new instance of the Rectangle class with the specified location and size.

フィールド

Empty

プロパティが初期化されていない状態の Rectangle 構造体を表します。Represents a Rectangle structure with its properties left uninitialized.

プロパティ

Bottom	この Rectangle 構造体の Y プロパティ値と Height プロパティ値の和である y 座標を取得します。Gets the y-coordinate that is the sum of the Y and Height property values of this Rectangle structure.
Height	この Rectangle 構造体の高さを取得または設定します。Gets or sets the height of this Rectangle structure.
IsEmpty	この Rectangle のすべての数値プロパティの値がゼロかどうかをテストします。Tests whether all numeric properties of this Rectangle have values of zero.
Left	この Rectangle 構造体の左端の x 座標を取得します。Gets the x-coordinate of the left edge of this Rectangle structure.
Location	この Rectangle 構造体の左上隅の座標を取得または設定します。Gets or sets the coordinates of the upper-left corner of this Rectangle structure.
Right	この Rectangle 構造体の X プロパティ値と Width プロパティ値の和である x 座標を取得します。Gets the x-coordinate that is the sum of X and Width property values of this Rectangle structure.
Size	この Rectangle のサイズを取得または設定します。Gets or sets the size of this Rectangle.
Top	この Rectangle 構造体の上端の y 座標を取得します。Gets the y-coordinate of the top edge of this Rectangle structure.
Width	この Rectangle 構造体の幅を取得または設定します。Gets or sets the width of this Rectangle structure.
X	この Rectangle 構造体の左上隅の x 座標を取得または設定します。Gets or sets the x-coordinate of the upper-left corner of this Rectangle structure.
Y	この Rectangle 構造体の左上隅の y 座標を取得または設定します。Gets or sets the y-coordinate of the upper-left corner of this Rectangle structure.

メソッド

Ceiling(RectangleF)	RectangleF の値を整数値に切り上げることで、指定された RectangleF 構造体を Rectangle 構造体に変換します。Converts the specified RectangleF structure to a Rectangle structure by rounding the RectangleF values to the next higher integer values.
Contains(Int32, Int32)	指定した点がこの Rectangle 構造体に含まれているかどうかを判断します。Determines if the specified point is contained within this Rectangle structure.
Contains(Point)	指定した点がこの Rectangle 構造体に含まれているかどうかを判断します。Determines if the specified point is contained within this Rectangle structure.
Contains(Rectangle)	この Rectangle 構造体に、`rect` によって表された四角形領域全体が含まれているかどうかを判断します。Determines if the rectangular region represented by `rect` is entirely contained within this Rectangle structure.
Equals(Object)	`obj` がこの Rectangle 構造体と同じ位置およびサイズの Rectangle 構造体かどうかをテストします。Tests whether `obj` is a Rectangle structure with the same location and size of this Rectangle structure.
Equals(Rectangle)
FromLTRB(Int32, Int32, Int32, Int32)	指定の端の位置の Rectangle 構造体を作成します。Creates a Rectangle structure with the specified edge locations.
GetHashCode()	この Rectangle 構造体のハッシュコードを返します。Returns the hash code for this Rectangle structure. ハッシュコードの使い方の詳細については、GetHashCode() のトピックを参照してください。For information about the use of hash codes, see GetHashCode() .
Inflate(Int32, Int32)	この Rectangle を指定の量だけ拡大します。Enlarges this Rectangle by the specified amount.
Inflate(Rectangle, Int32, Int32)	指定の Rectangle 構造体の拡大したコピーを作成して返します。Creates and returns an enlarged copy of the specified Rectangle structure. コピーは、指定した量だけ拡大されます。The copy is enlarged by the specified amount. 元の Rectangle 構造体は変更されません。The original Rectangle structure remains unmodified.
Inflate(Size)	この Rectangle を指定の量だけ拡大します。Enlarges this Rectangle by the specified amount.
Intersect(Rectangle)	この Rectangle をそれ自体と指定の Rectangle の交差部分に置き換えます。Replaces this Rectangle with the intersection of itself and the specified Rectangle.
Intersect(Rectangle, Rectangle)	他の 2 つの Rectangle 構造体の交差部分を表す 3 番目の Rectangle 構造体を返します。Returns a third Rectangle structure that represents the intersection of two other Rectangle structures. 交差部分がない場合は、空の Rectangle が返されます。If there is no intersection, an empty Rectangle is returned.
IntersectsWith(Rectangle)	この四角形が `rect` と交差するかどうかを判断します。Determines if this rectangle intersects with `rect`.
Offset(Int32, Int32)	四角形の位置を指定した量によって調節します。Adjusts the location of this rectangle by the specified amount.
Offset(Point)	四角形の位置を指定した量によって調節します。Adjusts the location of this rectangle by the specified amount.
Round(RectangleF)	RectangleF の値を最も近い整数値に丸めることで、指定された RectangleF を Rectangle に変換します。Converts the specified RectangleF to a Rectangle by rounding the RectangleF values to the nearest integer values.
ToString()	この Rectangle の属性をユーザーが判読できる文字列に変換します。Converts the attributes of this Rectangle to a human-readable string.
Truncate(RectangleF)	RectangleF の値を切り捨てることで、指定された RectangleF を Rectangle に変換します。Converts the specified RectangleF to a Rectangle by truncating the RectangleF values.
Union(Rectangle, Rectangle)	2 つの Rectangle 構造体の結合領域を包む Rectangle 構造体を取得します。Gets a Rectangle structure that contains the union of two Rectangle structures.

演算子

Equality(Rectangle, Rectangle)	2 つの Rectangle 構造体の位置およびサイズが同じかどうかをテストします。Tests whether two Rectangle structures have equal location and size.
Inequality(Rectangle, Rectangle)	2 つの Rectangle 構造体の位置またはサイズが異なるかどうかをテストします。Tests whether two Rectangle structures differ in location or size.