CircleHotSpot.GetCoordinates Method

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.

Returns a string that represents the x- and y-coordinates of a CircleHotSpot object's center and the length of its radius.

public:
 override System::String ^ GetCoordinates();

public override string GetCoordinates ();

override this.GetCoordinates : unit -> string

Public Overrides Function GetCoordinates () As String

Returns

String

A string that represents the x- and y-coordinates of a CircleHotSpot object's center and the length of its radius.

Examples

The following code example demonstrates how to declaratively create an ImageMap control that contains two CircleHotSpot objects. When a user clicks one of the CircleHotSpot objects, the GetCoordinates method returns its coordinates and displays them to the user. 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 ShopMap_Clicked(object sender, ImageMapEventArgs e)
  {    
    string coordinates;
    
    // When a user clicks the Circle1 hot spot,
    // display the hot spot's coordinates.
    //if (e.Value == "Circle1")
    if (e.PostBackValue.ToString() == "Circle1")
    {
      coordinates = Shop.HotSpots[0].GetCoordinates();
      Message1.Text = "The hot spot's coordinates are " + coordinates + ".";
    }
      
    // When a user clicks the Circle2 hot spot,
    // display the hot spot's coordinates.
    //else if (e.Value == "Circle2")
    else if (e.PostBackValue.ToString() == "Circle2")
    {
      coordinates = Shop.HotSpots[1].GetCoordinates ();
      Message1.Text = "The hot spot's coordinates are " + coordinates + ".";
    }
    else
      Message1.Text = "You did not click a valid hot spot region.";        
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>CircleHotSpot.GetCoordinates Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>CircleHotSpot.GetCoordinates Example</h3>
      
      <h4>Shopping Choices:</h4>
      
      <asp:imagemap id="Shop"           
        imageurl="Images/ShopChoice.jpg" 
        width="150"
        height="360" 
        onclick="ShopMap_Clicked"
        alternatetext="Shopping choices"
        runat="Server">    
        
        <asp:circlehotspot
          postbackvalue="Circle1"
          x="75"
          y="120"
          radius="75"
          hotspotmode="PostBack"
          alternatetext="Shop for toys.">           
        </asp:circlehotspot> 
        
        <asp:circlehotspot
          postbackvalue="Circle2"
          x="75"
          y="290"
          radius="75"
          hotspotmode="PostBack"
          alternatetext="Shop for wine.">           
        </asp:circlehotspot>     
          
      </asp:imagemap>          
      
      <br />
          
      <asp:label id="Message1"
        runat="Server">
      </asp:label>             
                 
    </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 ShopMap_Clicked(ByVal sender As Object, ByVal e As ImageMapEventArgs)
    
    Dim coordinates As String
    
    ' When a user clicks the Circle1 hot spot,
    ' display the hot spot's coordinates.
    If (e.PostBackValue.ToString() = "Circle1") Then
      coordinates = Shop.HotSpots(0).GetCoordinates()
      Message1.Text = "The hot spot's coordinates are " & coordinates & "."
                     
      ' When a user clicks the Circle2 hot spot,
      ' display the hot spot's coordinates.
    ElseIf (e.PostBackValue.ToString() = "Circle2") Then
      coordinates = Shop.HotSpots(1).GetCoordinates()
      Message1.Text = "The hot spot's coordinates are " & coordinates & "."
      
    Else
      Message1.Text = "You did not click a valid hot spot region."
                
    End If
        
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>CircleHotSpot.GetCoordinates Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>CircleHotSpot.GetCoordinates Example</h3>
      
      <h4>Shopping Choices:</h4>
      
      <asp:imagemap id="Shop"           
        imageurl="Images/ShopChoice.jpg"
        width = "150"
        height = "360"
        onclick="ShopMap_Clicked"
        alternatetext="Shopping choices"
        runat="Server">    
        
        <asp:circlehotspot
          postbackvalue="Circle1"
          x="75"
          y="120"
          radius="75"
          hotspotmode="PostBack"
          alternatetext="Shop for toys.">           
        </asp:circlehotspot> 
        
        <asp:circlehotspot
          postbackvalue="Circle2"
          x="75"
          y="290"
          radius="75"
          hotspotmode="PostBack"
          alternatetext="Shop for wine.">           
        </asp:circlehotspot>     
          
      </asp:imagemap>          
      
      <br />
          
      <asp:label id="Message1"
        runat="Server">
      </asp:label>             
                 
    </form>      
  </body>
</html>

Remarks

This method uses the values assigned to the X and Y properties to return the center coordinates and the value assigned to the Radius property to return the radius.

The GetCoordinates method is used internally by ASP.NET to get the text to use for the coordinates of a CircleHotSpot when it is rendered.

Applies to

Jaa