Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

RectangleHotSpot.Top Property

Note: This property is new in the .NET Framework version 2.0.

Gets or sets the y-coordinate of the top side of the rectangular region defined by this RectangleHotSpot object.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public int Top { get; set; }
/** @property */
public int get_Top ()

/** @property */
public void set_Top (int value)

public function get Top () : int

public function set Top (value : int)

Property Value

The y-coordinate of the top side of the rectangular region defined by this RectangleHotSpot object. The default is 0.

The Top property allows you to get or set a value that represents the y-coordinate of the top side of the rectangular region defined by this RectangleHotSpot object. To completely define a RectangleHotSpot object. you must specify a value for this property and for the Left, Right, and Bottom properties.

The following code example demonstrates how to declaratively create an ImageMap control that contains two RectangleHotSpot objects. One RectangleHotSpot object is created declaratively and its properties, including the Top property, are set declaratively. The other RectangleHotSpot object is created programmatically and its properties, including the Top property, 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#" %>

<script runat="server">
  void Page_Load(object sender, EventArgs e)
  {
    // Programmatically create a RectangleHotSpot.
    RectangleHotSpot Rectangle1 = new RectangleHotSpot();
    
    // Set properties on Rectangle1.
    Rectangle1.Top = 0;
    Rectangle1.Left = 0;
    Rectangle1.Bottom = 200;
    Rectangle1.Right = 200;
    Rectangle1.PostBackValue = "Yes";
    Rectangle1.AlternateText = "Vote yes";
         
    // Add the RectangleHotSpot object to the
    // Vote ImageMap control's HotSpotCollection.
    Vote.HotSpots.Add(Rectangle1);  
  }
  
  void VoteMap_Clicked(object sender, ImageMapEventArgs e)
  {       
    // When a user clicks the "Yes" hot spot,
    // display the hot spot's value.
    if (e.PostBackValue == "Yes")
      Message1.Text = "You selected " + e.PostBackValue + ".";

    else if (e.PostBackValue == "No") 
      // When a user clicks the "No" hot spot,
      // display the hot spot's value.       
      Message1.Text = "You selected " + e.PostBackValue + ".";
      
    else
      Message1.Text = "You did not click a valid hot spot region.";
                
  }

</script>

<html>
<head id="Head1" runat="server">
  <title>RectangleHotSpot Properties Example</title>
</head>
  <body>
    <form id="Form1" runat="server">
    
      <h3>RectangleHotSpot Properties Example</h3>
      
      <!-- Change or remove the width and height attributes as
           appropriate for your image. -->
      <asp:imagemap id="Vote"           
        imageurl="Images/VoteImage.jpg" 
        alternatetext="Voting choices"
        hotspotmode="PostBack"
        width="400"
        height="200"
        onclick="VoteMap_Clicked"   
        runat="Server">            
        
        <asp:RectangleHotSpot 
          top="0"
          left="201"
          bottom="200"
          right="400"
          postbackvalue="No"
          alternatetext="Vote no">
        </asp:RectangleHotSpot>
        
      </asp:imagemap>
      
      <br />
      
      <asp:label id="Message1"
        runat="Server">
      </asp:label>
              
    </form>      
  </body>
</html>

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.