LegendItem.MapAreaAttributes Właściwość

Definicja

Przestrzeń nazw:

System.Web.UI.DataVisualization.Charting

Zestaw:

System.Web.DataVisualization.dll

Pobiera lub ustawia atrybuty obszaru mapy elementu legendy.

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

Wartość właściwości

String

Wartość string reprezentująca atrybuty odpowiedniego obszaru mapy dla elementu legendy.

Implementuje

MapAreaAttributes

Atrybuty

BindableAttribute PersistenceModeAttribute

Uwagi

Jeśli ustawisz właściwość , zostanie automatycznie utworzona mapa obrazu MapAreaAttributes po stronie klienta. Zostanie również utworzony obszar mapy z ciągiem atrybutu dołączonym do tagu odpowiadającego obiektowi wykresu, dla którego jest <map> ustawiana ta właściwość.

Na przykład ustawienie atrybutu Target przy użyciu tej właściwości i właściwości pierwszego punktu danych spowoduje kod HTML podobny do Url następującego kodu:

<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>

Ponieważ cały ciąg jest dołączany do tagu, wiele atrybutów powinno być oddzielonych <map> spacją.

Właściwość może być używana w połączeniu z właściwością w celu określenia atrybutów obszaru mapy, na przykład target= _blank, a także programów obsługi zdarzeń po stronie klienta, na przykład MapAreaAttributes Url OnClick="MyEvent()".

Ustawienie tej właściwości nie będzie mieć wpływu, jeśli IsMapEnabled właściwość jest ustawiona na false wartość . Jego wartość domyślna to true .

Ważne

Aby utworzyć mapę obrazów w ten sposób, właściwość obiektu RenderType Chart musi być ustawiona na wartość ImageTag . Istnieje możliwość utworzenia mapy obrazu w przypadku przesyłania strumieniowego danych binarnych, ale należy użyć innej techniki. Aby uzyskać więcej informacji, zobacz Chart Image Rendering (Renderowanie obrazów wykresów).

Podczas ustawiania tej właściwości można użyć specjalnych słów kluczowych. Każde słowo kluczowe zostanie zastąpione typem danych z odpowiedniego elementu wykresu. Zapoznaj się z następującą tabelą, aby uzyskać listę wszystkich dostępnych słów kluczowych:

Słowo kluczowe	Zastępuje
#VALX	Wartość X punktu danych.
#VAL, #VALY, #VALY2, #VALY3...	Wartości Y punktu danych.
#SER	Nazwa serii.
#LABEL	Etykieta punktu danych.
#INDEX	Indeks punktów danych.
#percent	Procent wartości Y punktu danych.
#TOTAL	Suma wszystkich wartości Y w serii.
#LEGENDTEXT	Tekst legendy.

Aby utworzyć mapy obrazów, które mają współrzędne zdefiniowane przez użytkownika, użyj MapAreas właściwości obiektu Chart głównego. Aby uzyskać więcej informacji, zobacz Chart Image Rendering (Renderowanie obrazów wykresów).

Uwaga

Ta właściwość ma zastosowanie do całego obiektu LegendItem .