Point Estrutura

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Primitives.dll

Origem:

Point.cs

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

public value class Point : IEquatable<System::Drawing::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>

[<System.ComponentModel.TypeConverter("System.Drawing.PointConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
type Point = struct

Public Structure Point
Implements IEquatable(Of Point)

Herança

Object

ValueType

Point

Atributos

TypeConverterAttribute

Implementações

IEquatable<Point>

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 Windows Forms. Create um formulário que contém um Button chamado 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

Point(Int32)	Inicializa uma nova instância do Point struct usando coordenadas especificadas por um valor inteiro.
Point(Int32, Int32)	Inicializa uma nova instância do Point struct com as coordenadas especificadas.
Point(Size)	Inicializa uma nova instância do Point struct de um Size.

Campos

Empty

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

Propriedades

IsEmpty	Obtém um valor que indica se este Point está vazio.
X	Obtém ou define a coordenada X este Point.
Y	Obtém ou define a coordenada Y deste Point.

Métodos

Add(Point, Size)	Adiciona o Size especificado no Point especificado.
Ceiling(PointF)	Converte o PointF especificado em um Point arredondando os valores do PointF para os valores de inteiro mais próximos.
Equals(Object)	Especifica se esta instância de ponto contém as mesmas coordenadas do objeto especificado.
Equals(Point)	Especifica se esta instância de ponto contém as mesmas coordenadas de outro ponto.
GetHashCode()	Retorna um código hash para este Point.
Offset(Int32, Int32)	Converte esse Point pela quantidade especificada.
Offset(Point)	Converte esse Point pelo Point especificado.
Round(PointF)	Converte o PointF especificado em um objeto Point, arredondando os valores PointF para o inteiro mais próximo.
Subtract(Point, Size)	Retorna o resultado da subtração do Size especificado do Point especificado.
ToString()	Converte este Point em uma cadeia de caracteres legível por humanos.
Truncate(PointF)	Converte o PointF especificado em um Point truncando os valores de PointF.

Operadores

Addition(Point, Size)	Move um Point por um Size determinado.
Equality(Point, Point)	Compara dois objetos Point. O resultado especifica se os valores das propriedades X e Y dos dois objetos Point são iguais.
Explicit(Point to Size)	Converte a estrutura especificada Point em uma estrutura Size.
Implicit(Point to PointF)	Converte a estrutura especificada Point em uma estrutura PointF.
Inequality(Point, Point)	Compara dois objetos Point. Especifica o resultado se os valores das propriedades X ou Y dos dois objetos Point são diferentes.
Subtraction(Point, Size)	Converte um Point pelo negativo de um Size fornecido.