Point Struktur
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt ein sortiertes Paar von ganzzahligen x- und y-Koordinaten dar, das einen Punkt in einer zweidimensionalen Ebene 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 die Verwendung der SystemPens Klasse veranschaulicht.
Dieses Beispiel wurde für die Verwendung mit Windows Forms entwickelt. Erstellen Sie ein Formular, das einen Button benannten Namen subtractButtonenthält. Fügen Sie den Code in das Formular ein, und rufen Sie die CreatePointsAndSizes Methode aus der Ereignisbehandlungsmethode des Formulars Paint auf und übergeben als ePaintEventArgs.
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
Zum Konvertieren eines in Point ein PointF, verwenden Sie Implicit.
Konstruktoren
| Name | Beschreibung |
|---|---|
| Point(Int32, Int32) |
Initialisiert eine neue Instanz der Point Struktur mit den angegebenen Koordinaten. |
| Point(Int32) |
Initialisiert eine neue Instanz der Struktur mithilfe von Koordinaten, die Point durch einen ganzzahligen Wert angegeben werden. |
| Point(Size) |
Initialisiert eine neue Instanz der Point Struktur aus einer Size. |
Felder
| Name | Beschreibung |
|---|---|
| Empty |
Stellt einen Point Wert dar, der auf Null festgelegt ist XY . |
Eigenschaften
| Name | Beschreibung |
|---|---|
| IsEmpty |
Ruft einen Wert ab, der angibt, ob dies Point leer ist. |
| X |
Ruft die x-Koordinate dieses Pointab, oder legt diese fest. |
| Y |
Ruft die y-Koordinate dieses Pointab, oder legt diese fest. |
Methoden
| Name | Beschreibung |
|---|---|
| Add(Point, Size) |
Fügt dem angegebenen Wert Size den angegebenen PointWert hinzu. |
| Ceiling(PointF) |
Wandelt den angegebenen PointF Wert in eine Point um, indem die Werte der werte der PointF nächsthöheren ganzzahligen Werte gerundet werden. |
| Equals(Object) |
Gibt an, ob diese Punktinstanz die gleichen Koordinaten wie das angegebene Objekt enthält. |
| Equals(Point) |
Gibt an, ob diese Punktinstanz die gleichen Koordinaten wie ein anderer Punkt enthält. |
| GetHashCode() |
Gibt einen Hashcode für diesen PointCode zurück. |
| Offset(Int32, Int32) |
Übersetzt dies Point um den angegebenen Betrag. |
| Offset(Point) | |
| Round(PointF) |
Wandelt das angegebene PointF Objekt in ein Point Objekt um, indem die PointF Werte auf die nächste ganze Zahl gerundet werden. |
| Subtract(Point, Size) |
Gibt das Ergebnis des Subtrahierens Size zurück, das aus dem angegebenen Angegeben wird Point. |
| ToString() |
Wandelt dies Point in eine lesbare Zeichenfolge um. |
| Truncate(PointF) |
Konvertiert den angegebenen PointF Wert in eine Point durch Abschneiden der Werte der PointF. |
Operatoren
| Name | Beschreibung |
|---|---|
| Addition(Point, Size) | |
| Equality(Point, Point) |
Vergleicht zwei Point-Objekte. Das Ergebnis gibt an, ob die Werte und XY Eigenschaften 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 beiden YPoint Objekte ungleich sind. |
| Subtraction(Point, Size) |
Übersetzt eine Point durch das Negative eines gegebenen Size. |