HotSpotCollection.Item[Int32] Property

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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

Default Public ReadOnly Property Item(index As Integer) As HotSpot

Parameters

index: Int32

The ordinal index value that specifies the location of the HotSpot object in the collection.

Property Value

HotSpot

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.

Applies to

Jaa