Microsoft.com
Bienvenido Iniciar sesión
Inicio de .NET Framework
 Versión imprimible       Enviar     
Evaluar y enviar comentarios

  Encender vista de ancho de banda bajo
Esta página es específica de
Microsoft Visual Studio 2005/.NET Framework 2.0

Hay además otras versiones disponibles para:
ImageButton (Clase)
Control que muestra una imagen y responde a los clics del mouse (ratón) en la imagen.

Espacio de nombres: System.Web.UI.WebControls
Ensamblado: System.Web (en system.web.dll)

Visual Basic (Declaración)
Public Class ImageButton
    Inherits Image
    Implements IPostBackDataHandler, IPostBackEventHandler, IButtonControl
Visual Basic (Uso)
Dim instance As ImageButton
C#
public class ImageButton : Image, IPostBackDataHandler, IPostBackEventHandler, IButtonControl
C++
public ref class ImageButton : public Image, IPostBackDataHandler, IPostBackEventHandler, IButtonControl
J#
public class ImageButton extends Image implements IPostBackDataHandler, IPostBackEventHandler, 
    IButtonControl
JScript
public class ImageButton extends Image implements IPostBackDataHandler, IPostBackEventHandler, 
    IButtonControl
XAML
No aplicable.

Utilice el control ImageButton para mostrar una imagen que responde a los clics del mouse.

Se provocan los eventos Click y Command cuando se hace clic en el control ImageButton.

Utilizando el controlador de eventos OnClick, se pueden determinar mediante programación las coordenadas del punto donde se ha hecho clic en la imagen. A continuación, se puede crear código de respuesta tomando como base los valores de las coordenadas. Observe que el origen (0, 0) está situado en la esquina superior izquierda de la imagen.

Se puede utilizar el controlador de eventos OnCommand para que el control ImageButton se comporte como un botón de comando. Se puede asociar un nombre de comando al control mediante la propiedad CommandName. Esto permite colocar varios controles ImageButton en la misma página Web. A continuación, el valor de la propiedad CommandName se puede identificar mediante programación en el controlador de eventos OnCommand para determinar la acción apropiada que debe realizarse cuando se hace clic en cada uno de los controles ImageButton. También puede utilizarse la propiedad CommandArgument para pasar más información sobre el comando, por ejemplo para especificar el orden ascendente.

De manera predeterminada, la validación de la página se realiza al hacer clic en un control ImageButton. La validación de la página determina si todos los controles de entrada asociados a un control de validación en la página cumplen las reglas de validación especificadas por el control de validación. Para evitar que se realice la validación de la página, establezca la propiedad CausesValidation en false.

Accesibilidad

Es posible que el marcado que se representa de manera predeterminada para este control no respete los estándares de accesibilidad enunciados en las directrices prioritarias de WCAG (Instrucciones de accesibilidad a contenido Web 1.0). Para obtener detalles sobre accesibilidad compatible con este control, vea Controles y accesibilidad en ASP.NET.

TopicLocation
Cómo: Agregar controles Button de servidor Web a una página de formularios Web FormsGenerar aplicaciones Web ASP .NET
Cómo: Agregar controles Button de servidor Web a una página de formularios Web Forms (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar controles Button de servidor Web a una página de formularios Web Forms (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar controles ImageButton de servidor Web a una página de formularios Web FormsGenerar aplicaciones Web ASP .NET
Cómo: Agregar controles ImageButton de servidor Web a una página de formularios Web Forms (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar controles ImageButton de servidor Web a una página de formularios Web Forms (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar un botón de inicio de sesión a una página Web ASP.NETGenerar aplicaciones Web ASP .NET
Cómo: Agregar un botón de inicio de sesión a una página Web ASP.NETGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Determinar las coordenadas de un control ImageButton de servidor WebGenerar aplicaciones Web ASP .NET
Cómo: Determinar las coordenadas de un control ImageButton de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Establecer el foco en los controles de servidor Web ASP.NETGenerar aplicaciones Web ASP .NET
Cómo: Establecer el foco en los controles de servidor Web ASP.NETGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a eventos Button en controles enlazados a datosGenerar aplicaciones Web ASP .NET
Cómo: Responder a eventos Button en controles enlazados a datosGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a los eventos de botón en elementos DataList o RepeaterGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a los eventos de botón en elementos DataList, Repeater o GridViewGenerar aplicaciones Web ASP .NET
Cómo: Responder a los eventos de un control Button de servidor WebGenerar aplicaciones Web ASP .NET
Cómo: Responder a los eventos de un control Button de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a los eventos de un control Button de servidor Web en una secuencia de comandos del clienteGenerar aplicaciones Web ASP .NET
Cómo: Responder a los eventos de un control Button de servidor Web en una secuencia de comandos del clienteGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear y usar páginas principales ASP.NET en Visual Web DeveloperGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear y usar páginas principales ASP.NET en Visual Web DeveloperGenerar aplicaciones con Visual Web Developer
Tutorial: Enlace de datos a un objeto comercial personalizadoGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Enlace de datos a un objeto comercial personalizadoGenerar aplicaciones Web ASP .NET en Visual Studio

En el ejemplo de código siguiente se muestra cómo crear un control ImageButton que muestra las coordenadas del punto donde se ha hecho clic en una imagen.

NotaNota:

El ejemplo de código siguiente utiliza un modelo de código de un solo archivo y puede no funcionar correctamente si se copia directamente en un archivo con el código subyacente. Se debe copiar este ejemplo de código en un archivo de texto vacío con la extensión .aspx. Para obtener más información sobre el modelo de código de los formularios Web Forms, vea Modelo de código de las páginas Web ASP.NET.

Visual Basic
<%@ 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  >
<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>
C#
<%@ 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  >
<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>
JScript
<%@ Page Language="JScript" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html  >
<head>
    <title>ImageButton Sample</title>
<script language="JSCRIPT" runat="server">

      function ImageButton_Click(sender : Object, e : ImageClickEventArgs) {
         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>
System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
       System.Web.UI.WebControls.Image
        System.Web.UI.WebControls.ImageButton
Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0
© 2009 Microsoft Corporation. Reservados todos los derechos. Términos de uso  |  Marcas Registradas  |  Privacidad
Page view tracker