MapArea Classe

Definição

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Representa uma área de 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 imagem 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, uma série, um item de legenda ou um objeto de linha de faixa - tem uma propriedade ou MapAreaAttributes um objeto não vazioToolTipUrl; 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 como false. O valor padrão é true.

Importante

Para criar um mapa de imagem 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 coordenadas e formas definidas pelo usuário.

Construtores

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

Propriedades

Nome	Description
Coordinates	Obtém ou define as coordenadas de um MapArea objeto.
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 Click evento.
Shape	Obtém ou define a forma de um MapArea objeto.
Tag	Obtém ou define um objeto associado a esse elemento de 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 âncora da área do mapa.

Métodos

Nome	Description
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 especificado Object é igual ao atual ChartElement. (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 Objectatual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o atual Object. (Herdado de ChartElement)