MapArea Classe

Definição

Espaço de Nomes:
System.Web.UI.DataVisualization.Charting
Assemblagem:
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

Observações

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

Os MapArea objetos são armazenados na MapAreasCollection turma.

Existem dois tipos de MapArea objetos:

  • Áreas de mapas que são criadas automaticamente quando um elemento de gráfico – por exemplo, um ponto de dados, série, legenda ou objeto de linha de tira – tem uma propriedade MapAreaAttributesUrl ou propriedade não vaziaToolTip; note que outros elementos HTML necessários para um mapa de imagem do lado do cliente também são criados. Neste caso, as dimensões e a localização de uma área do mapa são automaticamente determinadas pelo elemento do mapa. Use o CustomizeMapAreas evento do objeto raiz Chart para eliminar ou modificar estas áreas do mapa em tempo de execução.

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

Definir esta propriedade não terá efeito se a IsMapEnabled propriedade for definida para false. O valor predefinido é 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 imagem usando streaming binário, mas é necessário usar outra técnica.

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

Tooltips, hiperligações 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 do mapa é um objeto personalizado MapArea ; ou seja, se tem forma e coordenadas definidas pelo utilizador.

Construtores

Name Description
MapArea()

Inicializa uma nova instância da MapArea classe.
MapArea(MapAreaShape, String, Single[])

Inicializa uma nova instância da MapArea classe com a forma, URL e coordenadas especificadas.
MapArea(MapAreaShape, String, String, String, String, Single[], Object)

Inicializa uma nova instância da MapArea classe com a forma especificada, texto da tooltip, URL, atributos, valor de postback, coordenadas e etiqueta.
MapArea(String, GraphicsPath)

Inicializa uma nova instância da MapArea classe com o URL e GraphicsPath objeto especificados.
MapArea(String, RectangleF)

Inicializa uma nova instância da MapArea classe com a URL e RectangleF estrutura especificadas.
MapArea(String, String, String, String, GraphicsPath, Object)

Inicializa uma nova instância da MapArea classe com o texto de tooltip especificado, URL, atributos, valor de postback, caminho e etiqueta.
MapArea(String, String, String, String, RectangleF, Object)

Inicializa uma nova instância da MapArea classe com o texto da tooltip especificado, URL, atributos, valor de postback, coordenadas retangulares e etiqueta.

Propriedades

Name Description
Coordinates

Obtém ou define as coordenadas de um MapArea objeto.
IsCustom

Recebe 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

Recebe ou define o valor de postback que pode ser processado num Click evento.
Shape

Obtém ou define a forma de um MapArea objeto.
Tag

Obtém ou define um objeto associado a este elemento do mapa.

(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 ponto de ancoragem da área do mapa.

Métodos

Name Description
Dispose()

Liberta os recursos usados pelo ChartElement.

(Herdado de ChartElement)
Dispose(Boolean)

Liberta os recursos não geridos usados pelo ChartElement e opcionalmente liberta os recursos geridos.

(Herdado de ChartElement)
Equals(Object)

Determina se o especificado Object é igual à corrente ChartElement.

(Herdado de ChartElement)
GetHashCode()

Devolve uma função de hash para um determinado tipo.

(Herdado de ChartElement)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa a corrente Object.

(Herdado de ChartElement)

Aplica-se a