Point Struktur

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>
[System.ComponentModel.TypeConverter(typeof(System.Drawing.PointConverter))]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct Point : IEquatable<System.Drawing.Point>
type Point = struct
Public Structure Point
Implements IEquatable(Of Point)
Vererbung
Attribute
Implementiert

Beispiele

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 die Verwendung der SystemPens -Klasse veranschaulicht.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 Button ein subtractButtonmit dem Namen enthält.Create a form that contains a Button named subtractButton. Fügen Sie den Code in das Formular ein, CreatePointsAndSizes und wenden Sie die- Paint Methode aus der Ereignis Behandlungsmethode e des PaintEventArgsFormulars an, indem Sie als übergeben.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

Hinweise

Um einen Point in einen PointFzu konvertieren, Implicitverwenden Sie.To convert a Point to a PointF, use Implicit.

Konstruktoren

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.

Felder

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.

Eigenschaften

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.

Methoden

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 dieser Point dieselben Koordinaten wie das angegebene Object enthält.Specifies whether this Point contains the same coordinates as the specified Object.

Equals(Point)
GetHashCode()

Gibt einen Hashcode für diesen 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.

Operatoren

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.

Gilt für: