LegendItem.MapAreaAttributes Propriedade

Definição

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Obtém ou define os atributos de área do mapa de um item de legenda.

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 string valor que representa os atributos da área de mapa correspondente para o item de legenda.

Implementações

MapAreaAttributes

Atributos

BindableAttribute PersistenceModeAttribute

Comentários

Se você definir a MapAreaAttributes propriedade, um mapa de imagem do lado do cliente será criado automaticamente. Uma área de mapa também será criada, com sua cadeia de caracteres de atributo acrescentada à marca de <mapa> que corresponde ao objeto de gráfico para o qual essa propriedade está sendo definida.

Por exemplo, definir o atributo Target usando essa propriedade e a Url propriedade do primeiro ponto de dados resultará em um código HTML semelhante ao seguinte código:

<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 é acrescentada à marca de <mapa> , vários atributos devem ser separados com um espaço.

A MapAreaAttributes propriedade pode ser usada em conjunto com a Url propriedade para especificar atributos de área de mapa, por exemplo, target= _blank, bem como manipuladores de eventos do lado do cliente, por exemplo, OnClick="MyEvent()".

Definir essa propriedade não terá efeito se a IsMapEnabled propriedade estiver definida como false. Seu 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 imagens ao usar o streaming binário, mas outra técnica deve ser usada. Para obter mais informações, consulte Renderização de Imagem do Gráfico.

Palavras-chave especiais podem ser usadas ao definir 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 listagem de todas as palavras-chave disponíveis:

Keyword	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 tenham coordenadas definidas pelo usuário, use a MapAreas propriedade do objeto raiz Chart . Para obter mais informações, consulte Renderização de Imagem do Gráfico.

Observação

Essa propriedade é aplicável a toda LegendItem.