ElementPosition Classe

Definição

Representa a classe base para vários elementos visuais do gráfico, como a legenda, o título e as áreas do gráfico.Represents the base class for many visual elements of the chart such as the legend, title, and chart areas. Define a posição do elemento gráfico em coordenadas relativas, que varia de (0,0) a (100,100).Defines the position of the chart element in relative coordinates, which range from (0,0) to (100,100).

public ref class ElementPosition : System::Windows::Forms::DataVisualization::Charting::ChartElement
public class ElementPosition : System.Windows.Forms.DataVisualization.Charting.ChartElement
type ElementPosition = class
    inherit ChartElement
Public Class ElementPosition
Inherits ChartElement
Herança
ElementPosition

Comentários

A ElementPosition classe é usada para definir a posição de um elemento de gráfico e representa um retângulo usando as Xpropriedades Y, Width e Height .The ElementPosition class is used to define the position of a chart element, and represents one rectangle using the X, Y, Width and Height properties.

A ElementPosition classe é sempre exposta como uma Position Propriedade, Positioncomo, Positione assim por diante.The ElementPosition class is always exposed as a Position property, such as Position, Position, and so forth. Ele também PrePaint é exposto nos eventos e PostPaint do Chart controle como uma propriedade do ChartPaintEventArgs objeto.It is also exposed in the PrePaint and PostPaint events of the Chart control as a property of the ChartPaintEventArgs object.

A posição dos elementos do gráfico aplicáveis pode ser definida automaticamente definindo a propriedade Auto como true; os elementos do gráfico também podem ser posicionados em tempo de design no modo de exibição de design.The position of the applicable chart elements can be set automatically by setting the Auto property to true; chart elements can also be positioned at design time in the Design View.

Há duas diferenças principais entre essa classe e uma RectangleF estrutura:There are two major differences between this class and a RectangleF structure:

  • Essa classe pode usar o posicionamento automático.This class can use automatic positioning.

  • Essa classe usa apenas coordenadas variando de 0 a 100, caso contrário, uma exceção é lançada.This class only uses coordinates ranging from 0 to 100, otherwise an exception is thrown.

A posição dos elementos do gráfico é descrita usando coordenadas relativas, com o canto superior esquerdo de um elemento com coordenadas de (0, 0) e o canto inferior direito de um elemento com coordenadas de (100.100).The position of chart elements is described using relative coordinates, with the top-left corner of an element having coordinates of (0,0) and the bottom-right corner of an element having coordinates of (100,100).

Os elementos que são plotados em uma área do gráfico usam coordenadas que são relativas à área do gráfico, enquanto os elementos fora de uma área do gráfico usam coordenadas que são relativas à imagem do gráfico.Elements that are plotted within a chart area use coordinates that are relative to the chart area, whereas elements outside a chart area use coordinates that are relative to the chart image.

Construtores

ElementPosition()

Inicializa uma nova instância da classe ElementPosition.Initializes a new instance of the ElementPosition class.

ElementPosition(Single, Single, Single, Single)

Inicializa uma nova instância da classe ElementPosition com os parâmetros x, y, width e height especificados.Initializes a new instance of the ElementPosition class with the specified x, y, width and height parameters.

Propriedades

Auto

Obtém ou define um valor que indica se um elemento do gráfico aplicável será posicionado automaticamente pelo controle Chart.Gets or sets a value that indicates whether an applicable chart element will be positioned automatically by the Chart control.

Bottom

Obtém a posição inferior de um elemento do gráfico, em coordenadas relativas.Gets the bottom position of a chart element, in relative coordinates.

Height

Obtém ou define a altura de um elemento do gráfico.Gets or sets the height of a chart element.

Right

Obtém a posição do lado direito de um elemento do gráfico, em coordenadas relativas.Gets the position of the right side of a chart element, in relative coordinates.

Size

Obtém o tamanho de um elemento do gráfico.Gets the size of a chart element.

Tag

Obtém ou define um objeto associado a esse elemento do gráfico.Gets or sets an object associated with this chart element.

(Herdado de ChartElement)
Width

Obtém ou define a largura de um elemento do gráfico.Gets or sets the width of a chart element.

X

Obtém ou define a coordenada X relativa do canto superior esquerdo de um elemento do gráfico aplicável.Gets or sets the relative X-coordinate of the top-left corner of an applicable chart element.

Y

Obtém ou define a coordenada Y relativa do canto superior esquerdo de um elemento do gráfico aplicável.Gets or sets the relative Y-coordinate of the top-left corner of an applicable chart element.

Métodos

Dispose()

Libera os recursos usados pelo ChartElement.Releases the resources used by the ChartElement.

(Herdado de ChartElement)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo ChartElement e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the ChartElement and optionally releases the managed resources.

(Herdado de ChartElement)
Equals(Object)

Determina se o Object especificado é igual ao ChartElement atual.Determines whether the specified Object is equal to the current ChartElement.

(Herdado de ChartElement)
FromRectangleF(RectangleF)

Inicializa um objeto ElementPosition de uma estrutura RectangleF.Initializes an ElementPosition object from a RectangleF structure.

GetHashCode()

Retorna uma função de hash para um tipo específico.Returns a hash function for a particular type.

(Herdado de ChartElement)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToRectangleF()

Retorna um objeto RectangleF que usa as coordenadas de um objeto ElementPosition.Returns a RectangleF object that uses the coordinates of an ElementPosition object.

ToString()

Retorna uma cadeia de caracteres que representa o Object atual.Returns a string that represents the current Object.

(Herdado de ChartElement)

Aplica-se a