MapArea.MapAreaAttributes Propriedade
Definição
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 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
Um valor string
que representa os atributos da área do mapa que corresponde a um elemento do gráfico específico.
Implementações
- Atributos
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.