MapArea.MapAreaAttributes Propriedade

Definição

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Obtém ou define os atributos da área do mapa.

public:
 property System::String ^ MapAreaAttributes { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Bindable(true)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.Attribute)]
public string MapAreaAttributes { get; set; }

[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.Attribute)>]
member this.MapAreaAttributes : string with get, set

Public Property MapAreaAttributes As String

Valor da propriedade

String

Um valor string que representa os atributos da área do mapa que corresponde a um elemento do gráfico específico.

Implementações

MapAreaAttributes

Atributos

BindableAttribute PersistenceModeAttribute

Comentários

Se você definir essa propriedade, um mapa de imagem do lado do cliente será criado automaticamente e uma área de mapa será criada com a cadeia de caracteres de atributo anexada à <MAP> marca que corresponde ao Chart objeto para o qual essa propriedade está sendo definida. Por exemplo, definir o atributo de destino usando essa propriedade e definir a Url Propriedade do primeiro ponto de dados resultará em código HTML semelhante ao seguinte:

<img id="Chart1" USEMAP="#Chart1ImageMap" src="ChartPic_000002.jpg?6735e83b-f0cd-4225-8be4-047695a61040" border="0" />...
<MAP NAME="Chart1ImageMap"><AREA SHAPE="rect" HREF="http://www.SomeDomain.ca" COORDS="69,120,106,309" Target=_Blank></MAP>

Como a cadeia de caracteres inteira é anexada à <MAP> marca, vários atributos devem ser separados por um espaço.

A MapAreaAttributes propriedade pode ser usada em conjunto com a Url propriedade para especificar atributos da área de mapa, como Target = _Blank, bem como manipuladores de eventos do lado do cliente, como onclick = "MyEvent ()".

Definir essa propriedade não terá efeito se a IsMapEnabled propriedade for definida como false . O valor padrão é true.

Importante

Para criar um mapa de imagem dessa maneira, a RenderType Propriedade do Chart objeto deve ser definida como ImageTag . É possível criar um mapa de imagem ao usar o streaming binário, mas outra técnica deve ser usada.

Palavras-chave especiais podem ser usadas quando você define essa propriedade. Cada palavra-chave será substituída por algum tipo de dados do elemento de gráfico aplicável. Consulte a tabela a seguir para obter uma lista de todas as palavras-chave disponíveis:

Palavra-chave	Substituído por
#VALX	Valor X do ponto de dados.
#VAL, #VALY, #VALY2, #VALY3...	Valores Y do ponto de dados.
#SER	Nome da série.
#LABEL	Rótulo do ponto de dados.
#INDEX	Índice do ponto de dados.
#PERCENT	Porcentagem do valor Y do ponto de dados.
#TOTAL	Total de todos os valores Y na série.
#LEGENDTEXT	Texto da legenda.

Para criar mapas de imagem que têm coordenadas definidas pelo usuário, use a MapAreas Propriedade do Chart objeto raiz.