Point Struct

Definition

Representa un par ordenado de coordenadas enteras x e y que define un punto en un plano bidimensional.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

En el ejemplo de código siguiente se crean puntos y tamaños mediante varios de los operadores sobrecargados definidos para estos tipos.The following code example creates points and sizes using several of the overloaded operators defined for these types. También se muestra cómo usar la clase SystemPens.It also demonstrates how to use the SystemPens class.

Este ejemplo está diseñado para usarse con Windows Forms.This example is designed to be used with Windows Forms. Cree un formulario que contenga un Button denominado subtractButton.Create a form that contains a Button named subtractButton. Pegue el código en el formulario y llame al método CreatePointsAndSizes desde el método de control de eventos Paint del formulario, pasando e como 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

Para convertir un Point en un PointF, utilice Implicit.To convert a Point to a PointF, use Implicit.

Constructors

Point(Int32)

Inicializa una nueva instancia de la clase Point con las coordenadas que especifica un valor entero.Initializes a new instance of the Point class using coordinates specified by an integer value.

Point(Int32, Int32)

Inicializa una nueva instancia de la clase Point con las coordenadas especificadas.Initializes a new instance of the Point class with the specified coordinates.

Point(Size)

Inicializa una nueva instancia de la clase Point a partir de un objeto Size.Initializes a new instance of the Point class from a Size.

Fields

Empty

Representa Point que hace X y los valores Y establecer para poner a cero.Represents a Point that has X and Y values set to zero.

Properties

IsEmpty

Obtiene un valor que indica si esta Point está vacía.Gets a value indicating whether this Point is empty.

X

Obtiene o establece la coordenada x de este objeto Point.Gets or sets the x-coordinate of this Point.

Y

Obtiene o establece la coordenada y de este objeto Point.Gets or sets the y-coordinate of this Point.

Methods

Add(Point, Size)

Agrega el Size especificado al Point especificado.Adds the specified Size to the specified Point.

Ceiling(PointF)

Convierte la estructura PointF especificada en una estructura Point redondeando los valores de PointF a los valores enteros superiores siguientes.Converts the specified PointF to a Point by rounding the values of the PointF to the next higher integer values.

Equals(Object)

Especifica si esta instancia de punto contiene las mismas coordenadas que el objeto especificado.Specifies whether this point instance contains the same coordinates as the specified object.

Equals(Point)

Especifica si esta instancia de punto contiene las mismas coordenadas que otro punto.Specifies whether this point instance contains the same coordinates as another point.

GetHashCode()

Devuelve un código hash para esta Point.Returns a hash code for this Point.

Offset(Int32, Int32)

Convierte este elemento Point en la cantidad especificada.Translates this Point by the specified amount.

Offset(Point)

Convierte este objeto Point según el Point especificado.Translates this Point by the specified Point.

Round(PointF)

Convierte la estructura PointF en un objeto Point redondeando los valores de PointF a los valores enteros más cercanos.Converts the specified PointF to a Point object by rounding the PointF values to the nearest integer.

Subtract(Point, Size)

Devuelve el resultado de la resta especificada Size del Point especificado.Returns the result of subtracting specified Size from the specified Point.

ToString()

Convierte esta estructura Point en una cadena legible para el usuario.Converts this Point to a human-readable string.

Truncate(PointF)

Convierte el objeto PointF especificado en Point mediante el truncamiento de los valores de PointF.Converts the specified PointF to a Point by truncating the values of the PointF.

Operators

Addition(Point, Size)

Convierte un Point según el valor de Size especificado.Translates a Point by a given Size.

Equality(Point, Point)

Compara dos objetos Point.Compares two Point objects. El resultado especifica si los valores de las propiedades X y Y de los dos objetos Point son iguales.The result specifies whether the values of the X and Y properties of the two Point objects are equal.

Explicit(Point to Size)

Convierte la estructura Point especificada en una estructura Size.Converts the specified Point structure to a Size structure.

Implicit(Point to PointF)

Convierte la estructura Point especificada en una estructura PointF.Converts the specified Point structure to a PointF structure.

Inequality(Point, Point)

Compara dos objetos Point.Compares two Point objects. El resultado especifica si los valores de las propiedades X y Y de los dos objetos Point no son iguales.The result specifies whether the values of the X or Y properties of the two Point objects are unequal.

Subtraction(Point, Size)

Convierte una estructura Point según el valor negativo del Size especificado.Translates a Point by the negative of a given Size.

Applies to