CircleHotSpot.Radius Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the distance from the center to the edge of the circular region defined by this CircleHotSpot object.
public:
property int Radius { int get(); void set(int value); };
public int Radius { get; set; }
member this.Radius : int with get, set
Public Property Radius As Integer
Property Value
An integer that represents the distance in pixels from the center to the edge of the circular region defined by this CircleHotSpot object. The default is 0.
Exceptions
The specified value is less than 0.
Examples
The following code example demonstrates how to create an ImageMap control that contains two CircleHotSpot objects. One is created declaratively; its X, Y, and Radius properties are likewise set declaratively. The other is created programmatically and its X, Y, and Radius properties are set programmatically. For this example to work correctly, you must supply your own image for the ImageUrl property and update the path to the image appropriately so that the application can locate it.
<%@ page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Page_Load (object sender, EventArgs e)
{
// Programmatically create a CircleHotSpot object.
CircleHotSpot Circle1 = new CircleHotSpot ();
// Set properties on the CircleHotSpot object.
Circle1.HotSpotMode = HotSpotMode.Navigate;
Circle1.NavigateUrl = "http://www.tailspintoys.com";
Circle1.X = 145;
Circle1.Y = 120;
Circle1.Radius = 75;
Circle1.AlternateText="Shop for toys";
// Add the CirclHotSpot object to the
// Shop ImageMap control's HotSpotCollection.
Shop.HotSpots.Add (Circle1);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>CircleHotSpot Properties Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>CircleHotSpot Example</h3>
<h4>Shopping Choices:</h4>
<asp:imagemap id="Shop"
imageurl="Images/ShopChoice.jpg"
alternatetext="Shopping choices"
runat="Server">
<asp:circlehotspot
navigateurl="http://www.cohowinery.com"
x="145"
y="290"
radius="75"
hotspotmode="Navigate"
alternatetext="Shop for wine">
</asp:circlehotspot>
</asp:imagemap>
</form>
</body>
</html>
<%@ page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
' Programmatically create a CircleHotSpot object.
Dim Circle1 As New CircleHotSpot
' Set properties on the CircleHotSpot object.
Circle1.HotSpotMode = HotSpotMode.Navigate
Circle1.NavigateUrl = "http://www.tailspintoys.com"
Circle1.X = 145
Circle1.Y = 120
Circle1.Radius = 75
Circle1.AlternateText = "Shop for toys"
' Add the CirclHotSpot object to the
' Shop ImageMap control's HotSpotCollection.
Shop.HotSpots.Add(Circle1)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>CircleHotSpot Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>CircleHotSpot Properties Example</h3>
<h4>Shopping Choices:</h4>
<asp:imagemap id="Shop"
imageurl="Images/ShopChoice.jpg"
alternatetext="Shopping choices"
runat="Server">
<asp:circlehotspot
navigateurl="http://www.cohowinery.com"
x="145"
y="290"
radius="75"
hotspotmode="Navigate"
alternatetext="Shop for wine">
</asp:circlehotspot>
</asp:imagemap>
</form>
</body>
</html>
Remarks
The Radius property allows you to get or set a value that represents the distance in pixels from the center to the edge of the circular region defined by this CircleHotSpot object. To completely define a CircleHotSpot object, you must specify a value for the Radius property as well as the X and Y properties.