LegendItem.MapAreaAttributes Propriedade

Referência

Definição

Namespace:: System.Web.UI.DataVisualization.Charting

Assembly:: System.Web.DataVisualization.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define os atributos de área de 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 propriedade , um mapa de imagem do lado do MapAreaAttributes cliente será criado automaticamente. Uma área de mapa também será criada, com sua cadeia de caracteres de atributo anexada à marca que corresponde ao objeto de gráfico para o qual essa <map> propriedade está sendo definida.

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

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

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

Importante

Para criar um mapa de imagem dessa maneira, a RenderType propriedade do objeto deve ser definida como Chart ImageTag . É possível criar um mapa de imagem ao usar streaming binário, mas outra técnica deve ser usada. Para obter mais informações, consulte Renderização de imagem de 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 ver 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	Percentual 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 MapAreas a propriedade do objeto Chart raiz. Para obter mais informações, consulte Renderização de imagem de gráfico.

Observação

Essa propriedade é aplicável a todo o LegendItem .

Aplica-se a

Partilhar via