Point Struct

Definition

Stellt ein geordnetes Paar von x- und y-Koordinaten als ganze Zahlen dar, das einen Punkt in einem zweidimensionalen Raum definiert.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
Inheritance
Attributes
Implements

Examples

Das folgende Codebeispiel erstellt Punkte und Größen mithilfe mehrerer der überladenen Operatoren, die für diese Typen definiert sind.The following code example creates points and sizes using several of the overloaded operators defined for these types. Außerdem wird veranschaulicht, wie die SystemPens-Klasse verwendet wird.It also demonstrates how to use the SystemPens class.

Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert.This example is designed to be used with Windows Forms. Erstellen Sie ein Formular, das eine Button mit dem Namen subtractButtonenthält.Create a form that contains a Button named subtractButton. Fügen Sie den Code in das Formular ein, und nennen Sie die CreatePointsAndSizes-Methode aus der Paint Ereignis Behandlungsmethode des Formulars, wobei e als PaintEventArgsübergeben werden.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

Remarks

Verwenden Sie Implicit, um eine Point in eine PointFzu konvertieren.To convert a Point to a PointF, use Implicit.

Constructors

Point(Int32)

Initialisiert eine neue Instanz der Point-Klasse unter Verwendung von als Ganzzahlwert angegebenen Koordinaten.Initializes a new instance of the Point class using coordinates specified by an integer value.

Point(Int32, Int32)

Initialisiert eine neue Instanz der Point-Klasse mit den angegebenen Koordinaten.Initializes a new instance of the Point class with the specified coordinates.

Point(Size)

Initialisiert eine neue Instanz der Point-Klasse mit einer Size.Initializes a new instance of the Point class from a Size.

Fields

Empty

Stellt einen Point dar, dessen X-Wert und Y-Wert auf 0 (null) festgelegt sind.Represents a Point that has X and Y values set to zero.

Properties

IsEmpty

Ruft einen Wert ab, der angibt, ob dieser Point leer ist.Gets a value indicating whether this Point is empty.

X

Ruft die x-Koordinate dieses Point ab oder legt diese fest.Gets or sets the x-coordinate of this Point.

Y

Ruft die y-Koordinate dieses Point ab oder legt diese fest.Gets or sets the y-coordinate of this Point.

Methods

Add(Point, Size)

Fügt dem angegebenen Size die angegebene Point hinzu.Adds the specified Size to the specified Point.

Ceiling(PointF)

Konvertiert den angegebenen PointF in einen Point, indem die Werte von PointF auf die nächsthöheren Ganzzahlwerte aufgerundet werden.Converts the specified PointF to a Point by rounding the values of the PointF to the next higher integer values.

Equals(Object)

Gibt an, ob diese Punktinstanz dieselben Koordinaten wie das angegebene Objekt aufweist.Specifies whether this point instance contains the same coordinates as the specified object.

Equals(Point)

Gibt an, ob diese Punktinstanz dieselben Koordinaten wie ein anderer Punkt aufweist.Specifies whether this point instance contains the same coordinates as another point.

GetHashCode()

Gibt einen Hashcode für diese Point zurück.Returns a hash code for this Point.

Offset(Int32, Int32)

Verschiebt diesen Point um den angegebenen Betrag.Translates this Point by the specified amount.

Offset(Point)

Verschiebt diesen Point um den angegebenen Point.Translates this Point by the specified Point.

Round(PointF)

Konvertiert den angegebenen PointF in ein Point-Objekt, indem die PointF-Werte auf die nächste ganze Zahl gerundet werden.Converts the specified PointF to a Point object by rounding the PointF values to the nearest integer.

Subtract(Point, Size)

Gibt das Ergebnis der Subtraktion der angegebenen Size vom angegebenen Point zurück.Returns the result of subtracting specified Size from the specified Point.

ToString()

Konvertiert diesen Point in eine lesbare Zeichenfolge.Converts this Point to a human-readable string.

Truncate(PointF)

Konvertiert den angegebenen PointF in einen Point, indem die Werte des PointF abgeschnitten werden.Converts the specified PointF to a Point by truncating the values of the PointF.

Operators

Addition(Point, Size)

Verschiebt einen Point um eine angegebene Size.Translates a Point by a given Size.

Equality(Point, Point)

Vergleicht zwei Point-Objekte.Compares two Point objects. Das Ergebnis gibt an, ob die Werte der X-Eigenschaft und der Y-Eigenschaft der beiden Point-Objekte gleich sind.The result specifies whether the values of the X and Y properties of the two Point objects are equal.

Explicit(Point to Size)

Konvertiert die angegebene Point-Struktur in eine Size-Struktur.Converts the specified Point structure to a Size structure.

Implicit(Point to PointF)

Konvertiert die angegebene Point-Struktur in eine PointF-Struktur.Converts the specified Point structure to a PointF structure.

Inequality(Point, Point)

Vergleicht zwei Point-Objekte.Compares two Point objects. Das Ergebnis gibt an, ob die Werte der X-Eigenschaft oder der Y-Eigenschaft der beiden Point-Objekte ungleich sind.The result specifies whether the values of the X or Y properties of the two Point objects are unequal.

Subtraction(Point, Size)

Verschiebt einen Point um den negativen Wert einer angegebenen Size.Translates a Point by the negative of a given Size.

Applies to