Point Struct

Definition

Consente di rappresentare una coppia ordinata di coordinate di valori interi x- e y per definire un punto in un piano a due dimensioni.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

Nell'esempio di codice seguente vengono creati punti e dimensioni usando molti degli operatori di overload definiti per questi tipi.The following code example creates points and sizes using several of the overloaded operators defined for these types. Viene inoltre illustrato come utilizzare la classe SystemPens.It also demonstrates how to use the SystemPens class.

Questo esempio è progettato per essere usato con Windows Forms.This example is designed to be used with Windows Forms. Creare un modulo che contenga un Button denominato subtractButton.Create a form that contains a Button named subtractButton. Incollare il codice nel form e chiamare il metodo CreatePointsAndSizes dal metodo di gestione degli eventi del form Paint, passando e come PaintEventArgs.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

Per convertire un Point in un PointF, utilizzare Implicit.To convert a Point to a PointF, use Implicit.

Constructors

Point(Int32)

Inizializza una nuova istanza della classe Point utilizzando coordinate specificate da un valore di tipo Integer.Initializes a new instance of the Point class using coordinates specified by an integer value.

Point(Int32, Int32)

Inizializza una nuova istanza della classe Point con le coordinate specificate.Initializes a new instance of the Point class with the specified coordinates.

Point(Size)

Inizializza una nuova istanza della classe Point da un oggetto Size.Initializes a new instance of the Point class from a Size.

Fields

Empty

Rappresenta un oggetto Point che presenta i valori X e Y impostati su zero.Represents a Point that has X and Y values set to zero.

Properties

IsEmpty

Ottiene un valore che indica se questa matrice Point è vuota.Gets a value indicating whether this Point is empty.

X

Ottiene o imposta la coordinata x di questo Point.Gets or sets the x-coordinate of this Point.

Y

Ottiene o imposta la coordinata y di questo Point.Gets or sets the y-coordinate of this Point.

Methods

Add(Point, Size)

Aggiunge la struttura Size specificata a un oggetto Point.Adds the specified Size to the specified Point.

Ceiling(PointF)

Converte la struttura PointF specificata in una struttura Point arrotondando i valori della struttura PointF agli interi immediatamente più alti.Converts the specified PointF to a Point by rounding the values of the PointF to the next higher integer values.

Equals(Object)

Specifica se questa istanza di punto contiene le stesse coordinate dell'oggetto specificato.Specifies whether this point instance contains the same coordinates as the specified object.

Equals(Point)

Specifica se questa istanza di punto contiene le stesse coordinate di un altro punto.Specifies whether this point instance contains the same coordinates as another point.

GetHashCode()

Ottiene un codice hash per l'oggetto Point.Returns a hash code for this Point.

Offset(Int32, Int32)

Trasla l'oggetto Point in base al valore specificato.Translates this Point by the specified amount.

Offset(Point)

Converte l'oggetto Point in base all'oggetto Point specificato.Translates this Point by the specified Point.

Round(PointF)

Converte l'oggetto PointF specificato in un oggetto Point arrotondando i valori di PointF agli interi più vicini.Converts the specified PointF to a Point object by rounding the PointF values to the nearest integer.

Subtract(Point, Size)

Restituisce il risultato della sottrazione dell'oggetto Size specificata dall'oggetto Point specificato.Returns the result of subtracting specified Size from the specified Point.

ToString()

Converte l'oggetto Point in una stringa leggibile.Converts this Point to a human-readable string.

Truncate(PointF)

Converte l'oggetto PointF specificato in un oggetto Point troncando i valori dell'oggetto PointF.Converts the specified PointF to a Point by truncating the values of the PointF.

Operators

Addition(Point, Size)

Converte un elemento Point in base a un determinato elemento Size.Translates a Point by a given Size.

Equality(Point, Point)

Confronta due oggetti Point.Compares two Point objects. Il risultato specifica se i valori delle proprietà X e Y dei due oggetti Point sono uguali.The result specifies whether the values of the X and Y properties of the two Point objects are equal.

Explicit(Point to Size)

Converte la struttura Point specificata in una struttura Size.Converts the specified Point structure to a Size structure.

Implicit(Point to PointF)

Converte la struttura Point specificata in una struttura PointF.Converts the specified Point structure to a PointF structure.

Inequality(Point, Point)

Confronta due oggetti Point.Compares two Point objects. Il risultato specifica se i valori delle proprietà X o Y dei due oggetti Point sono diversi.The result specifies whether the values of the X or Y properties of the two Point objects are unequal.

Subtraction(Point, Size)

Converte un elemento Point in base al valore negativo di un elemento Size.Translates a Point by the negative of a given Size.

Applies to