8.4 ImageButton
| Klasse
|
System.Web.UI.WebControls.ImageButton
|
| Deklaration
|
<asp:ImageButton id="ImageButton1"
ImageUrl="string"
OnCommand="OnCommandMethod"
Command="Command"
CommandArgument="CommandArgument"
CausesValidation="true | false"
OnClick="OnClickMethod"
runat="server"/>
|
| Erzeugter HTML-Code
|
<input type="image" name="..." id="..." src="..." border="..." />
|
| Kurzcharakteristik
|
ImageButton zeigt eine anklickbare Grafik an. Damit bietet ein ImageButton die Funktionalität eines Buttons. Zusätzlich sind die Koordinaten verfügbar, an denen die Grafik angeklickt wurde.
|
Alles, was beim Button-Steuerelement gesagt wurde, gilt auch für den ImageButton. Wenn Sie eine Ereignisprozedur definieren, müssen Sie allerdings auf die korrekte Signatur achten. Statt eines Objekts vom Typ EventArgs benötigen Sie hier ein Objekt des Typs System.Web.UI.ImageClickEventArgs.
webserver_imagebutton01.aspx demonstriert ein einfaches Beispiel. Wenn der Anwender das Bild anklickt, erfährt er die Koordinaten der Stelle, die er angeklickt hat. Abbildung 8.4 zeigt die Darstellung im Browser.
Hier klicken, um das Bild zu Vergrößern
Abbildung 8.4 Das ImageButton-Element kann die Koordinaten, an denen das Bild angeklickt wurde, übertragen.
<!-- webserver_imagebutton01.aspx -->
<%@ Page Language="VB" Debug="True" Strict="True" %>
<script runat="server" debug="true">
Sub btnImg_OnClick (sender As Object, _
e As System.Web.UI.ImageClickEventArgs)
anzeige.Text = _
"Die Koordinaten des Autors lauten: x = " _
& e.X.ToString() _
& ", y = " _
& e.Y.ToString() & "."
End Sub
</script>
<html><head>
<title>Webserversteuerelemente: ImageButton</title>
</head><body>
<form runat="server" id ="myForm">
<p>Wo sitzt der Autor? Bitte anklicken.</p>
<asp:ImageButton id="btnImg"
ImageUrl="img/arbeit.jpg"
OnClick="btnImg_OnClick"
runat="server"/>
<p>
<asp:Label
id="anzeige"
Text =""
runat="server" />
</p></form></body></html>
|
