Point 構造体

定義

2 次元面の 1 点を定義する、順序付けされた整数の X 座標と Y 座標のペアを表します。Represents an ordered pair of integer x- and y-coordinates that defines a point in a two-dimensional plane.

public value class Point : IEquatable<System::Drawing::Point>
public value class Point
[System.ComponentModel.TypeConverter("System.Drawing.PointConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public struct Point : IEquatable<System.Drawing.Point>
public struct Point
public struct Point : IEquatable<System.Drawing.Point>
[System.ComponentModel.TypeConverter(typeof(System.Drawing.PointConverter))]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct Point
type Point = struct
Public Structure Point
Implements IEquatable(Of Point)
Public Structure Point
継承
属性
実装

次のコード例では、これらの型に対して定義されたいくつかのオーバーロードされた演算子を使用して、ポイントとサイズを作成します。The following code example creates points and sizes using several of the overloaded operators defined for these types. また、SystemPens クラスの使用方法も示します。It also demonstrates how to use the SystemPens class.

この例は、Windows フォームと共に使用するように設計されています。This example is designed to be used with Windows Forms. subtractButtonという名前の Button を含むフォームを作成します。Create a form that contains a Button named subtractButton. フォームにコードを貼り付け、フォームの Paint イベント処理メソッドから CreatePointsAndSizes メソッドを呼び出して、ePaintEventArgsとして渡します。Paste the code into the form and call the CreatePointsAndSizes method from the form's Paint event-handling method, passing e as PaintEventArgs.

void CreatePointsAndSizes( PaintEventArgs^ e )
{
   // Create the starting point.
   Point startPoint = Point(subtractButton->Size);
   
   // Use the addition operator to get the end point.
   Point endPoint = startPoint + System::Drawing::Size( 140, 150 );
   
   // Draw a line between the points.
   e->Graphics->DrawLine( SystemPens::Highlight, startPoint, endPoint );
   
   // Convert the starting point to a size and compare it to the
   // subtractButton size.  
   System::Drawing::Size buttonSize = (System::Drawing::Size)startPoint;
   if ( buttonSize == subtractButton->Size )
   {
      e->Graphics->DrawString( "The sizes are equal.", gcnew System::Drawing::Font( this->Font,FontStyle::Italic ), Brushes::Indigo, 10.0F, 65.0F );
   }
}
private void CreatePointsAndSizes(PaintEventArgs e)
{

    // Create the starting point.
    Point startPoint = new Point(subtractButton.Size);

    // Use the addition operator to get the end point.
    Point endPoint = startPoint + new Size(140, 150);

    // Draw a line between the points.
    e.Graphics.DrawLine(SystemPens.Highlight, startPoint, endPoint);

    // Convert the starting point to a size and compare it to the
    // subtractButton size.  
    Size buttonSize = (Size)startPoint;
    if (buttonSize == subtractButton.Size)

        // If the sizes are equal, tell the user.
    {
        e.Graphics.DrawString("The sizes are equal.", 
            new Font(this.Font, FontStyle.Italic), 
            Brushes.Indigo, 10.0F, 65.0F);
    }
}
Private Sub CreatePointsAndSizes(ByVal e As PaintEventArgs)

    ' Create the starting point.
    Dim startPoint As New Point(subtractButton.Size)

    ' Use the addition operator to get the end point.
    Dim endPoint As Point = Point.op_Addition(startPoint, _
        New Size(140, 150))

    ' Draw a line between the points.
    e.Graphics.DrawLine(SystemPens.Highlight, startPoint, endPoint)

    ' Convert the starting point to a size and compare it to the
    ' subtractButton size.  
    Dim buttonSize As Size = Point.op_Explicit(startPoint)
    If (Size.op_Equality(buttonSize, subtractButton.Size)) Then

        ' If the sizes are equal, tell the user.
        e.Graphics.DrawString("The sizes are equal.", _
            New Font(Me.Font, FontStyle.Italic), _
            Brushes.Indigo, 10.0F, 65.0F)
    End If

End Sub

注釈

PointPointFに変換するには、Implicitを使用します。To convert a Point to a PointF, use Implicit.

コンストラクター

Point(Int32)

整数値で指定された座標を使用して、Point クラスの新しいインスタンスを初期化します。Initializes a new instance of the Point class using coordinates specified by an integer value.

Point(Int32, Int32)

座標を指定して、Point クラスの新しいインスタンスを初期化します。Initializes a new instance of the Point class with the specified coordinates.

Point(Size)

Point から Size クラスの新しいインスタンスを初期化します。Initializes a new instance of the Point class from a Size.

フィールド

Empty

Point および X の値をゼロに設定した Y を表します。Represents a Point that has X and Y values set to zero.

プロパティ

IsEmpty

この Point が空かどうかを示す値を取得します。Gets a value indicating whether this Point is empty.

X

この Point の x 座標を取得または設定します。Gets or sets the x-coordinate of this Point.

Y

この Point の y 座標を取得または設定します。Gets or sets the y-coordinate of this Point.

メソッド

Add(Point, Size)

指定した Size を指定した Point に追加します。Adds the specified Size to the specified Point.

Ceiling(PointF)

指定された PointF の値を整数値に切り上げることで、その PointPointF に変換します。Converts the specified PointF to a Point by rounding the values of the PointF to the next higher integer values.

Equals(Object)

このポイントに、指定したオブジェクトと同じ座標が含まれているかどうかを示します。Specifies whether this point instance contains the same coordinates as the specified object.

Equals(Point)

このポイント インスタンスに別の点と同じ座標が含まれているかどうかを指定します。Specifies whether this point instance contains the same coordinates as another point.

GetHashCode()

この Point のハッシュ コードを返します。Returns a hash code for this Point.

Offset(Int32, Int32)

この Point を指定の量だけ変換します。Translates this Point by the specified amount.

Offset(Point)

この Point を指定した Point だけ移動します。Translates this Point by the specified Point.

Round(PointF)

指定された PointF の値を最も近い整数に丸めることで、その PointPointF オブジェクトに変換します。Converts the specified PointF to a Point object by rounding the PointF values to the nearest integer.

Subtract(Point, Size)

指定した Size から指定した Point を減算した結果を返します。Returns the result of subtracting specified Size from the specified Point.

ToString()

この Point をユーザーが判読できる文字列に変換します。Converts this Point to a human-readable string.

Truncate(PointF)

指定された PointF の値を切り捨てることで、その PointPointF に変換します。Converts the specified PointF to a Point by truncating the values of the PointF.

演算子

Addition(Point, Size)

Point を指定の Size だけ移動します。Translates a Point by a given Size.

Equality(Point, Point)

2 つの Point オブジェクトを比較します。Compares two Point objects. この結果は、2 つの X オブジェクトの Y プロパティと Point プロパティの値が等しいかどうかを示します。The result specifies whether the values of the X and Y properties of the two Point objects are equal.

Explicit(Point to Size)

指定した Point 構造体を Size 構造体に変換します。Converts the specified Point structure to a Size structure.

Implicit(Point to PointF)

指定した Point 構造体を PointF 構造体に変換します。Converts the specified Point structure to a PointF structure.

Inequality(Point, Point)

2 つの Point オブジェクトを比較します。Compares two Point objects. この結果は、2 つの X オブジェクトの Y プロパティと Point プロパティの値が異なるかどうかを示します。The result specifies whether the values of the X or Y properties of the two Point objects are unequal.

Subtraction(Point, Size)

Point を指定の Size だけ負の方向へ移動します。Translates a Point by the negative of a given Size.

適用対象