This documentation is archived and is not being maintained.

HtmlInputImage.OnServerClick Method

Raises the ServerClick event.

[Visual Basic]
Protected Overridable Sub OnServerClick( _
   ByVal e As ImageClickEventArgs _
)
[C#]
protected virtual void OnServerClick(
 ImageClickEventArgs e
);
[C++]
protected: virtual void OnServerClick(
 ImageClickEventArgs* e
);
[JScript]
protected function OnServerClick(
   e : ImageClickEventArgs
);

Parameters

e
A System.Web.UI.ImageClickEventArgs that contains event data.

Remarks

The ServerClick event is raised when the user clicks an HtmlInputImage control.

The coordinates where the user clicks an HtmlInputImage control can be determined by using the ImageClickEventArgs.X and ImageClickEventArgs.Y properties of the System.Web.UI.ImageClickEventArgs object. The System.Web.UI.ImageClickEventArgs object is passed as a parameter to the user-defined event handler.

Note   The origin (0, 0) is located at the upper left corner of the image.

Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

The OnServerClick method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors:  When overriding OnServerClick in a derived class, be sure to call the base class's OnServerClick method so that registered delegates receive the event.

Example

[Visual Basic, C#, JScript] The following example demonstrates how to specify and code a handler for the ServerClick event to determine the coordinates where the user clicks the HtmlInputImage control.

[Visual Basic] 
<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
 
   <script language="VB" runat=server>
      
      Sub ImageBtn_Click(ByVal Sender as Object, ByVal E as ImageClickEventArgs)

         Span1.InnerText = "You clicked at (" & E.X.ToString() & _
                           ", " & E.Y.ToString() & ")."
      
      End Sub
   </script>

<body>

   <form runat="server">

      <h3>Click on the Image </h3>

      <input type=image
             src="Image1.jpg" 
             OnServerClick="ImageBtn_Click"
             runat=server/>

      <br>

      <span id="Span1" 
            runat="server"/>

   </form>

</body>
</html>
   

[JScript] 
<%@ Page Language="JScript" AutoEventWireup="True" %>

<html>
 
   <script language="JSCRIPT" runat=server>
      
      function ImageBtn_Click(sender : Object, e : ImageClickEventArgs){

         Span1.InnerText = "You clicked at (" + e.X.ToString()
                         + ", " + e.Y.ToString() + ")."
      
      }
   </script>

<body>

   <form runat="server">

      <h3>Click on the Image </h3>

      <input type=image
             src="Image1.jpg" 
             OnServerClick="ImageBtn_Click"
             runat=server/>

      <br>

      <span id="Span1" 
            runat="server"/>

   </form>

</body>
</html>
   

[Visual Basic] 

<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
 
   <script runat="server">
      
      Sub ImageBtn_Click(sender as Object, e as ImageClickEventArgs)

         ' Display the coordinates of the position where the image 
         ' was clicked.
         Span1.InnerText = "You clicked at (" & e.X.ToString() & _
                           ", " & e.Y.ToString() & ")."
      
      End Sub

      Sub Page_Load(sender as Object, e as EventArgs)
      
         ' Create an EventHandler delegate for the method you want to 
         ' handle the event, and then add it to the list of methods called
         ' when the event is raised.
         AddHandler Image1.ServerClick, AddressOf ImageBtn_Click

      End Sub

   </script>

<body>

   <form runat="server">

      <h3>HtmlInputImage ServerClick Example </h3>

      <input type="image"
             id="Image1"
             src="Image.jpg" 
             runat=server/>

      <br>

      <span id="Span1" 
            runat="server"/>

   </form>

</body>
</html>


[C#] 

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
 
   <script runat="server">
      
      void ImageBtn_Click(Object sender, ImageClickEventArgs e)
      {

         // Display the coordinates of the position where the image 
         // was clicked. 
         Span1.InnerText = "You clicked at (" + e.X.ToString() +
                           ", " + e.Y.ToString() + ").";
      
      }

      void Page_Load(Object sender, EventArgs e)
      {
      
         // Create an EventHandler delegate for the method you want to 
         // handle the event, and then add it to the list of methods called
         // when the event is raised.
         Image1.ServerClick += new ImageClickEventHandler(this.ImageBtn_Click);

      }

   </script>

<body>

   <form runat="server">

      <h3>HtmlInputImage ServerClick Example </h3>

      <input type="image"
             id="Image1"
             src="Image.jpg" 
             runat=server/>

      <br>

      <span id="Span1" 
            runat="server"/>

   </form>

</body>
</html>

[C++] No example is available for C++. To view a Visual Basic, C#, or JScript example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

HtmlInputImage Class | HtmlInputImage Members | System.Web.UI.HtmlControls Namespace | ServerClick | System.Web.UI.ImageClickEventArgs

Show: