MapArea Classe

Definição

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Representa uma área do mapa.

public ref class MapArea : System::Web::UI::DataVisualization::Charting::ChartNamedElement, System::Web::UI::DataVisualization::Charting::IChartMapArea

public class MapArea : System.Web.UI.DataVisualization.Charting.ChartNamedElement, System.Web.UI.DataVisualization.Charting.IChartMapArea

type MapArea = class
    inherit ChartNamedElement
    interface IChartMapArea

Public Class MapArea
Inherits ChartNamedElement
Implements IChartMapArea

Herança

Object

ChartElement

ChartNamedElement

MapArea

Implementações

IChartMapArea

Comentários

A MapArea classe representa uma área de mapa de um mapa de imagens do lado do cliente e corresponde a uma marca HTML <AREA> .

Os MapArea objetos são armazenados na MapAreasCollection classe .

Há dois tipos de MapArea objetos:

• Áreas de mapa que são criadas automaticamente quando um elemento de gráfico - por exemplo, um ponto de dados, série, item de legenda ou objeto de linha de faixa - tem uma propriedade não vazia ToolTipUrl ou MapAreaAttributes ; observe que outros elementos HTML necessários para um mapa de imagem do lado do cliente também são criados. Nesse caso, as dimensões e o local de uma área de mapa são determinados automaticamente pelo elemento de gráfico. Use o CustomizeMapAreas evento do objeto raiz Chart para excluir ou modificar essas áreas de mapa em tempo de execução.

• Áreas de mapa personalizadas que têm uma forma e coordenadas definidas pelo usuário. Use a MapAreas propriedade do objeto para adicionar essas áreas de mapa personalizadas em tempo de design ou tempo de Chart execução.

Definir essa propriedade não terá efeito se a IsMapEnabled propriedade estiver definida falsecomo . O valor padrão é true.

Importante

Para criar um mapa de imagens usando os objetos descritos MapArea anteriormente, a RenderType propriedade do Chart objeto deve ser definida como ImageTag. É possível criar um mapa de imagens ao usar o streaming binário, mas outra técnica deve ser usada.

Para objetos personalizados MapArea , a Shape propriedade determina a forma e a Coordinates propriedade determina o local da área do mapa.

Dicas de ferramenta, hiperlinks ou atributos, como Target=_Blank ou OnClick="javascript:MyJavaScriptFunction()", podem ser definidos para todas as áreas do mapa.

Use a IsCustom propriedade para determinar se uma área de mapa é um objeto personalizado MapArea ; ou seja, se ela tem a forma e as coordenadas definidas pelo usuário.

Construtores

MapArea()	Inicializa uma nova instância da classe MapArea.
MapArea(MapAreaShape, String, Single[])	Inicializa uma nova instância da classe MapArea com as coordenadas, a URL e a forma especificadas.
MapArea(MapAreaShape, String, String, String, String, Single[], Object)	Inicializa uma nova instância da classe MapArea com a forma, o texto de dica de ferramenta, a URL, os atributos, o valor de postback, as coordenadas e a marca especificados.
MapArea(String, GraphicsPath)	Inicializa uma nova instância da classe MapArea com a URL e o objeto GraphicsPath especificados.
MapArea(String, RectangleF)	Inicializa uma nova instância da classe MapArea com a URL e a estrutura RectangleF especificadas.
MapArea(String, String, String, String, GraphicsPath, Object)	Inicializa uma nova instância da classe MapArea com o texto de dica de ferramenta, a URL, os atributos, o valor de postback, o caminho e a marca especificados.
MapArea(String, String, String, String, RectangleF, Object)	Inicializa uma nova instância da classe MapArea com o texto de dica de ferramenta, a URL, os atributos, o valor de postback, as coordenadas do retângulo e a marca especificados.

Propriedades

Coordinates	Obtém ou define as coordenadas de um objeto MapArea.
IsCustom	Obtém ou define um valor que indica se a área do mapa é personalizada.
MapAreaAttributes	Obtém ou define os atributos da área do mapa.
Name	Obtém ou define o nome da área do mapa.
PostBackValue	Obtém ou define o valor de postback que pode ser processado em um evento Click.
Shape	Obtém ou define a forma de um objeto MapArea.
Tag	Obtém ou define um objeto associado a esse elemento do gráfico. (Herdado de ChartElement)
ToolTip	Obtém ou define a dica de ferramenta para a área do mapa.
Url	Obtém ou define a URL de destino ou o ponto de ancoragem da área do mapa.

Métodos

Dispose()	Libera os recursos usados pelo ChartElement. (Herdado de ChartElement)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo ChartElement e opcionalmente libera os recursos gerenciados. (Herdado de ChartElement)
Equals(Object)	Determina se o Object especificado é igual ao ChartElement atual. (Herdado de ChartElement)
GetHashCode()	Retorna uma função de hash para um tipo específico. (Herdado de ChartElement)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o Object atual. (Herdado de ChartElement)