Controllo server Web ImageButton
Consente di gestire gli eventi Click dell'utente in un'immagine, offrendo una funzionalità simile a una mappa immagine.
<asp:ImageButtonid="ImageButton1" ImageUrl="string" Command="Command" CommandArgument="CommandArgument" CausesValidation="true | false" OnClick="OnClickMethod" runat="server"/>
Osservazioni
Utilizzare il controllo ImageButton per visualizzare un'immagine che risponde ai clic del mouse. Se si imposta la proprietà ImageUrl, è possibile specificare l'immagine da visualizzare nel controllo.
Quando si fa clic sul controllo ImageButton, vengono generati entrambi gli eventi Click e Command.
Se si utilizza il gestore eventi OnClick, è possibile determinare a livello di codice le coordinate del punto in cui si fa clic sull'immagine. È quindi possibile codificare una risposta in base ai valori delle coordinate. Si noti che l'origine (0, 0) è posizionata nell'angolo superiore sinistro dell'immagine.
È possibile utilizzare il gestore eventi OnCommand per fare in modo che il controllo ImageButton funzioni come un pulsante di comando. Se si utilizza la proprietà CommandName, è possibile associare un nome di comando al controllo. In tal modo si possono inserire più controlli ImageButton nella stessa pagina Web. Il valore della proprietà CommandName può quindi essere identificato a livello di codice nel gestore eventi OnCommand, per determinare l'azione appropriata da eseguire quando si fa clic su ogni controllo ImageButton. Inoltre, è possibile utilizzare la proprietà CommandArgument per passare ulteriori informazioni sul comando, ad esempio per specificare l'ordinamento crescente.
Nota Poiché l'elemento <asp:ImageButton> non ha contenuto, è possibile chiudere il tag con /> anziché utilizzare un tag di chiusura distinto.
Per impostazione predefinita, la convalida della pagina viene eseguita quando si fa clic su un controllo ImageButton. La convalida della pagina consente di determinare se i controlli di input associati a un controllo di convalida nella pagina passano le regole di convalida specificate dal controllo di convalida stesso. Se è presente un controllo ImageButton che disattiva questa funzionalità, ad esempio un pulsante di reimpostazione, impostare la proprietà CausesValidation su false.
Per informazioni dettagliate sulle proprietà e sugli eventi del controllo server Web ImageButton vedere la documentazione di Classe ImageButton.
Esempio
Nell'esempio seguente viene mostrato come utilizzare un controllo ImageButton per visualizzare le coordinate del puntatore del mouse quando si fa clic sull'immagine.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script 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 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" %>
<html>
<head>
<script runat="server">
void ImageButton_Click(object Source, ImageClickEventArgs e)
{
Label1.Text="You clicked the ImageButton control at the " +
"Coordinates: (" + e.X.ToString() + ", " +
e.Y.ToString() + ")";
}
</script>
</head>
<body>
<form runat="server">
<h3>ImageButton Sample</h3>
Click anywhere on the image.<br><br>
<asp:ImageButton id="imagebutton1"
AlternateText="ImageButton 1"
ImageAlign="left"
ImageUrl="images\pict.jpg"
OnClick="ImageButton_Click"
runat="server"/>
<br><br>
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>