Point Estrutura

Definição

Representa um par ordenado de coordenadas inteiros x e y que define um ponto em um plano bidimensional.

public value class Point
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
public struct Point
public struct Point : IEquatable<System.Drawing.Point>
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.PointConverter))>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type Point = struct
type Point = struct
Public Structure Point
Public Structure Point
Implements IEquatable(Of Point)
Herança
Atributos
Implementações

Exemplos

O exemplo de código a seguir cria pontos e tamanhos usando vários dos operadores sobrecarregados definidos para esses tipos. Ele também demonstra como usar a SystemPens classe.

Este exemplo foi projetado para ser usado com o Windows Forms. Crie um formulário que contenha um Button nome subtractButton. Cole o código no formulário e chame o CreatePointsAndSizes método do método de tratamento de eventos do Paint formulário, passando e como 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

Comentários

Para converter um Point em um PointF, use Implicit.

Construtores

Nome Description
Point(Int32, Int32)

Inicializa uma nova instância do Point struct com as coordenadas especificadas.

Point(Int32)

Inicializa uma nova instância do Point struct usando coordenadas especificadas por um valor inteiro.

Point(Size)

Inicializa uma nova instância do Point struct de um Size.

Campos

Nome Description
Empty

Representa um Point que tem X e Y valores definidos como zero.

Propriedades

Nome Description
IsEmpty

Obtém um valor que indica se isso Point está vazio.

X

Obtém ou define a coordenada x deste Point.

Y

Obtém ou define a coordenada y deste Point.

Métodos

Nome Description
Add(Point, Size)

Adiciona o especificado Size ao especificado Point.

Ceiling(PointF)

Converte o especificado PointF em um Point arredondando os valores dos PointF próximos valores inteiros mais altos.

Equals(Object)

Especifica se essa instância de ponto contém as mesmas coordenadas que o objeto especificado.

Equals(Point)

Especifica se essa instância de ponto contém as mesmas coordenadas de outro ponto.

GetHashCode()

Retorna um código hash para isso Point.

Offset(Int32, Int32)

Traduz isso Point pela quantidade especificada.

Offset(Point)

Traduz isso Point pelo especificado Point.

Round(PointF)

Converte o especificado PointF em um Point objeto arredondando os PointF valores para o inteiro mais próximo.

Subtract(Point, Size)

Retorna o resultado da subtração especificada Size do especificado Point.

ToString()

Converte isso Point em uma cadeia de caracteres legível por humanos.

Truncate(PointF)

Converte o especificado PointF em um Point truncando os valores do PointF.

Operadores

Nome Description
Addition(Point, Size)

Converte um Point por um determinado Size.

Equality(Point, Point)

Compara dois objetos Point. O resultado especifica se os valores e as XY propriedades dos dois Point objetos são iguais.

Explicit(Point to Size)

Converte a estrutura especificada Point em uma Size estrutura.

Implicit(Point to PointF)

Converte a estrutura especificada Point em uma PointF estrutura.

Inequality(Point, Point)

Compara dois objetos Point. O resultado especifica se os valores dos X dois Point objetos ou Y propriedades são diferentes.

Subtraction(Point, Size)

Converte um Point pelo negativo de um determinado Size.

Aplica-se a