HotSpotCollection.Item[Int32] 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 a reference to the HotSpot object at the specified index in the HotSpotCollection collection.
public:
property System::Web::UI::WebControls::HotSpot ^ default[int] { System::Web::UI::WebControls::HotSpot ^ get(int index); };public System.Web.UI.WebControls.HotSpot this[int index] { get; }member this.Item(int) : System.Web.UI.WebControls.HotSpotDefault Public ReadOnly Property Item(index As Integer) As HotSpotParameters
- index
- Int32
The ordinal index value that specifies the location of the HotSpot object in the collection.
Property Value
The HotSpot object at the specified index in the HotSpotCollection collection.
Examples
The following code example demonstrates how to use the Item[] property to directly access the HotSpot objects contained in the ImageMap control's HotSpotCollection collection and display the value of each object's AlternateText property in a label on the page. 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.
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server" language="C#">
void Page_Load(object sender, EventArgs e)
{
// Use the indexer to access each object in the
// HotSpotCollection and display the value of
// its AlternateText property to the user.
for (int i = 0; i <= Shop.HotSpots.Count - 1; i++)
{
Label1.Text += "<br />" + Shop.HotSpots[i].AlternateText + "<br />";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>HotSpotCollection.Item Property Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>HotSpotCollection.Item Property Example</h3>
<h4>Shopping Choices:</h4>
<asp:imagemap id="Shop"
imageurl="Images/ShopChoice.jpg"
alternatetext="Shopping choices"
runat="Server">
<asp:circlehotspot
navigateurl="http://www.tailspintoys.com"
x="145"
y="120"
radius="75"
hotspotmode="Navigate"
alternatetext="Shop for toys">
</asp:circlehotspot>
<asp:circlehotspot
navigateurl="http://www.cohowinery.com"
x="145"
y="290"
radius="75"
hotspotmode="Navigate"
alternatetext="Shop for wine">
</asp:circlehotspot>
</asp:imagemap>
<asp:label id="Label1"
runat="Server">
</asp:label>
</form>
</body>
</html>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server" language="vb">
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
' Use the Item property to access each object in the
' HotSpotCollection and display the value of
' its AlternateText property to the user.
For i As Integer = 0 To Shop.HotSpots.Count - 1
Label1.Text += "<br />" + Shop.HotSpots.Item(i).AlternateText + "<br />"
Next
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>HotSpotCollection.Item Property Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>HotSpotCollection.Item Property Example</h3>
<h4>Shopping Choices:</h4>
<asp:imagemap id="Shop"
imageurl="Images/ShopChoice.jpg"
alternatetext="Shopping choices"
runat="Server">
<asp:circlehotspot
navigateurl="http://www.tailspintoys.com"
x="145"
y="120"
radius="75"
hotspotmode="Navigate"
alternatetext="Shop for toys">
</asp:circlehotspot>
<asp:circlehotspot
navigateurl="http://www.cohowinery.com"
x="145"
y="290"
radius="75"
hotspotmode="Navigate"
alternatetext="Shop for wine">
</asp:circlehotspot>
</asp:imagemap>
<asp:label id="Label1"
runat="Server">
</asp:label>
</form>
</body>
</html>
Remarks
Use this indexer to access a HotSpot object in the collection at the specified index, using array notation. The indexer allows you to modify or replace a HotSpot object in the collection directly.
