Dundas Chart for ASP.NET
Href Property
See Also  Send comments on this topic.
Dundas.Charting.WebControl Namespace > DataPointAttributes Class : Href Property


Gets or sets the destination URL or anchor point of the data point.


URL target of the area.

Syntax

Visual Basic (Declaration)  
Public Property Href As String
Visual Basic (Usage) Copy Code
Dim instance As DataPointAttributes
Dim value As String
 
instance.Href = value
 
value = instance.Href
C#  
public string Href {get; set;}

Return Value

A value that represents the destination URL or anchor point of the chart element. To use an absolute URL start the string expression with either "http://" or "www.". If the string does not start with either of these prefixes it will be treated as a relative URL.

Remarks

Setting this property will automatically result in a client-side image map being created, and a map area will be created with the HREF attribute set to the specified anchor or URL. This map area will also use the dimensions that correspond to the relevant chart element. For example, if the HREF property is set for a data point then html code similar to the following will be generated at run-time:

<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.healthquotes.ca" COORDS= "69,120,106,309">
</MAP>

Setting this property will have no effect if the Chart object's MapEnabled property is set to false (true by default).

IMPORTANT: To create an image map this way the RenderType property of the Chart object MUST be RenderType.ImageTag. It is possible to create an image map when using binary streaming, but another technique must be used. Refer to the Client-Side Mapping and Binary Streaming  topic for further details.

If the Href property is set for both a series and a data point of that series then the data point property has precedence.

Attributes of the map area(s) can be specified by using the MapAreaAttributes property (e.g. TARGET=_Blank).

This property allows you to set special keywords to display different types of Chart-related data. For more information, refer to the Using Keywords topic.

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

Refer to the Client-Side Image Maps topic for more information on how to implement client-side mage maps.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

Copyright © 2001 - 2009 Dundas Data Visualization, Inc. and others.