Point Struktur

Definition

Stellt ein geordnetes Paar von x- und y-Koordinaten als ganze Zahlen dar, das einen Punkt in einem zweidimensionalen Raum definiert.

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
[<System.ComponentModel.TypeConverter("System.Drawing.PointConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
type Point = struct
type Point = struct
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.PointConverter))>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type Point = struct
Public Structure Point
Implements IEquatable(Of Point)
Public Structure Point
Vererbung
Attribute
Implementiert

Beispiele

Im folgenden Codebeispiel werden Punkte und Größen mithilfe mehrerer der für diese Typen definierten überladenen Operatoren erstellt. Außerdem wird veranschaulicht, wie die SystemPens -Klasse verwendet wird.

Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert. Create ein Formular mit dem Button Namen subtractButton. Fügen Sie den Code in das Formular ein, und rufen Sie die CreatePointsAndSizes -Methode aus der Ereignisbehandlungsmethode des Formulars Paint auf, und übergeben Sie e als 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

Hinweise

Verwenden Sie Implicit, um eine Point in eine PointFzu konvertieren.

Konstruktoren

Point(Int32)

Initialisiert eine neue Instanz der Point-Struktur unter Verwendung von als Ganzzahlwert angegebenen Koordinaten.

Point(Int32, Int32)

Initialisiert eine neue Instanz der Point-Struktur mit den angegebenen Koordinaten.

Point(Size)

Initialisiert eine neue Instanz der Point-Struktur von einer Size aus.

Felder

Empty

Stellt einen Point dar, dessen X-Wert und Y-Wert auf 0 (null) festgelegt sind.

Eigenschaften

IsEmpty

Ruft einen Wert ab, der angibt, ob dieser Point leer ist.

X

Ruft die x-Koordinate dieses Point ab oder legt diese fest.

Y

Ruft die y-Koordinate dieses Point ab oder legt diese fest.

Methoden

Add(Point, Size)

Fügt dem angegebenen Size die angegebene Point hinzu.

Ceiling(PointF)

Konvertiert den angegebenen PointF in einen Point, indem die Werte von PointF auf die nächsthöheren Ganzzahlwerte aufgerundet werden.

Equals(Object)

Gibt an, ob diese Punktinstanz dieselben Koordinaten wie das angegebene Objekt aufweist.

Equals(Point)

Gibt an, ob diese Punktinstanz dieselben Koordinaten wie ein anderer Punkt aufweist.

GetHashCode()

Gibt einen Hashcode für diese Point zurück.

Offset(Int32, Int32)

Verschiebt diesen Point um den angegebenen Betrag.

Offset(Point)

Verschiebt diesen Point um den angegebenen Point.

Round(PointF)

Konvertiert den angegebenen PointF in ein Point-Objekt, indem die PointF-Werte auf die nächste ganze Zahl gerundet werden.

Subtract(Point, Size)

Gibt das Ergebnis der Subtraktion der angegebenen Size vom angegebenen Point zurück.

ToString()

Konvertiert diesen Point in eine lesbare Zeichenfolge.

Truncate(PointF)

Konvertiert den angegebenen PointF in einen Point, indem die Werte des PointF abgeschnitten werden.

Operatoren

Addition(Point, Size)

Verschiebt einen Point um eine angegebene Size.

Equality(Point, Point)

Vergleicht zwei Point-Objekte. Das Ergebnis gibt an, ob die Werte der X-Eigenschaft und der Y-Eigenschaft der beiden Point-Objekte gleich sind.

Explicit(Point to Size)

Konvertiert die angegebene Point-Struktur in eine Size-Struktur.

Implicit(Point to PointF)

Konvertiert die angegebene Point-Struktur in eine PointF-Struktur.

Inequality(Point, Point)

Vergleicht zwei Point-Objekte. Das Ergebnis gibt an, ob die Werte der X-Eigenschaft oder der Y-Eigenschaft der beiden Point-Objekte ungleich sind.

Subtraction(Point, Size)

Verschiebt einen Point um den negativen Wert einer angegebenen Size.

Gilt für: