Edit

Title.MapAreaAttributes Property

  • Reference

Definition

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

Gets or sets the map area attributes of the title.

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

Property Value

String

A string value that represents the map area attributes of the title. The default is a zero-length string.

Implements

MapAreaAttributes
Attributes
BindableAttribute PersistenceModeAttribute

Remarks

If you set the MapAreaAttributes property, a client-side image map will automatically be created. A map area will also be created, with its attribute string appended to the <MAP> tag that corresponds to the chart object for which this property is being set.

Because the entire attribute string is appended to the <MAP> tag, multiple attributes should be separated with a space.

The MapAreaAttributes property can be used in conjunction with the Url property to specify map area attributes, for example, Target= _Blank, as well as client-side event handlers, for example, OnClick="MyEvent()".

Setting this property will have no effect if the IsMapEnabled property is set to false. Its default value is true.

Important

To create an image map in this manner, the RenderType property of the Chart object must be set to ImageTag. It is possible to create an image map when using binary streaming, but another technique must be used.

Special keywords may be used when setting this property; each keyword will be replaced with some type of data from the applicable chart element. Refer to the following table for a listing of all available keywords:

Keyword Replaced by
#VALX X-value of the data point.
#VAL, #VALY, #VALY2, #VALY3… Y-values of the data point.
#SER Series name.
#LABEL Data point label.
#INDEX Data point index.
#PERCENT Percentage of the data point Y-value.
#TOTAL Total of all Y-values in the series.
#LEGENDTEXT Legend text.

To create image maps that have user-defined coordinates, use the MapAreas property of the root Chart object.

Applies to