ImageButton.OnClick(ImageClickEventArgs) Método

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Provoca el evento Click y permite controlar directamente el evento Click.

protected:
 virtual void OnClick(System::Web::UI::ImageClickEventArgs ^ e);
protected virtual void OnClick (System.Web.UI.ImageClickEventArgs e);
abstract member OnClick : System.Web.UI.ImageClickEventArgs -> unit
override this.OnClick : System.Web.UI.ImageClickEventArgs -> unit
Protected Overridable Sub OnClick (e As ImageClickEventArgs)

Parámetros

e
ImageClickEventArgs

Objeto ImageClickEventArgs que contiene los datos del evento.

Ejemplos

En el ejemplo siguiente se muestra cómo especificar y codificar un controlador para el Click evento para mostrar las coordenadas en las que el usuario hace clic en la imagen.

Nota

En el ejemplo de código siguiente se usa el modelo de código de un solo archivo y es posible que no funcione correctamente si se copia directamente en un archivo de código subyacente. Este ejemplo de código debe copiarse en un archivo de texto vacío que tenga una extensión .aspx. Para obtener más información sobre el modelo de código de Web Forms, consulte ASP.NET Web Forms Modelo de código de página.

<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ImageButton Sample</title>
<script language="C#" runat="server">

      void ImageButton_Click(object sender, ImageClickEventArgs e) 
      {
         Label1.Text = "You clicked the ImageButton control at the coordinates: (" + 
                       e.X.ToString() + ", " + e.Y.ToString() + ")";
      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>ImageButton Sample</h3>

      Click anywhere on the image.<br /><br />

      <asp:ImageButton id="imagebutton1" runat="server"
           AlternateText="ImageButton 1"
           ImageAlign="left"
           ImageUrl="images/pict.jpg"
           OnClick="ImageButton_Click"/>

      <br /><br />
    
      <asp:label id="Label1" runat="server"/>

   </form>

</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ImageButton Sample</title>
<script language="VB" runat="server">

      Sub ImageButton_Click(sender As Object, e As ImageClickEventArgs) 
         Label1.Text = "You clicked the ImageButton control at the coordinates: (" & _ 
                       e.X.ToString() & ", " & e.Y.ToString() & ")"
      End Sub

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>ImageButton Sample</h3>

      Click anywhere on the image.<br /><br />

      <asp:ImageButton id="imagebutton1" runat="server"
           AlternateText="ImageButton 1"
           ImageAlign="left"
           ImageUrl="images/pict.jpg"
           OnClick="ImageButton_Click"/>

      <br /><br />
    
      <asp:label id="Label1" runat="server"/>

   </form>

</body>
</html>

Comentarios

El Click evento se genera cuando se hace clic en el ImageButton control. Mediante el uso del OnClick controlador de eventos, puede determinar mediante programación las coordenadas en las que se hace clic en la imagen. A continuación, puede codificar una respuesta, en función de los valores de estas coordenadas. Tenga en cuenta que el origen (0, 0) se encuentra en la esquina superior izquierda de la imagen.

Cuando se genera un evento, se invoca el controlador de eventos a través de un delegado. Para obtener más información, vea Cómo: Consumir eventos en una aplicación de Web Forms.

El método OnClick también permite que las clases derivadas controlen el evento sin adjuntar ningún delegado. Ésta es la técnica preferida para controlar el evento en una clase derivada.

Notas a los desarrolladores de herederos

Al reemplazar OnClick(ImageClickEventArgs) en una clase derivada, asegúrese de llamar al método OnClick(ImageClickEventArgs) de la clase base para que los delegados registrados reciban el evento.

Se aplica a

Consulte también