ImageButton.OnClick(ImageClickEventArgs) Método

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Gera o evento Click e permite manipular o evento Click diretamente.

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

Um ImageClickEventArgs que contém os dados do evento.

Exemplos

O exemplo a seguir demonstra como especificar e codificar um manipulador para o Click evento para exibir as coordenadas em que o usuário clica na imagem.

Observação

O exemplo de código a seguir usa o modelo de código de arquivo único e pode não funcionar corretamente se copiado diretamente em um arquivo code-behind. Este exemplo de código deve ser copiado em um arquivo de texto vazio que tenha uma extensão .aspx. Para obter mais informações sobre o modelo de código do Web Forms, consulte ASP.NET Modelo de Código de Página dos Web Forms.

<%@ 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>

Comentários

O Click evento é gerado quando o ImageButton controle é clicado. Usando o OnClick manipulador de eventos, você pode determinar programaticamente as coordenadas em que a imagem é clicada. Em seguida, você pode codificar uma resposta, com base nos valores dessas coordenadas. Observe que a origem (0, 0) está localizada no canto superior esquerdo da imagem.

A geração de um evento invoca o manipulador de eventos por meio de um delegado. Para obter mais informações, consulte Como consumir eventos em um aplicativo web forms.

O OnClick método também permite que classes derivadas manipulem o evento sem anexar um delegado. Essa é a técnica preferencial para lidar com o evento em uma classe derivada.

Notas aos Herdeiros

Ao substituir OnClick(ImageClickEventArgs) em uma classe derivada, chame o método da OnClick(ImageClickEventArgs) classe base para que os delegados registrados recebam o evento.

Aplica-se a

Confira também