HtmlInputImage.OnServerClick-Methode
Löst das ServerClick-Ereignis aus.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Protected Overridable Sub OnServerClick ( _
e As ImageClickEventArgs _
)
'Usage
Dim e As ImageClickEventArgs
Me.OnServerClick(e)
protected virtual void OnServerClick (
ImageClickEventArgs e
)
protected:
virtual void OnServerClick (
ImageClickEventArgs^ e
)
protected void OnServerClick (
ImageClickEventArgs e
)
protected function OnServerClick (
e : ImageClickEventArgs
)
Parameter
- e
Ein System.Web.UI.ImageClickEventArgs, das Ereignisdaten enthält.
Hinweise
Das ServerClick-Ereignis wird ausgelöst, wenn der Benutzer auf ein HtmlInputImage-Steuerelement klickt.
Die Koordinaten, an denen der Benutzer auf ein HtmlInputImage-Steuerelement klickt, können durch Verwendung der ImageClickEventArgs.X-Eigenschaft und der ImageClickEventArgs.Y-Eigenschaft des System.Web.UI.ImageClickEventArgs-Objekts bestimmt werden. Das System.Web.UI.ImageClickEventArgs-Objekt wird als Parameter an den benutzerdefinierten Ereignishandler übergeben.
Hinweis
Der Ausgangspunkt (0, 0) befindet sich in der oberen linken Ecke des Bildes.
Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen finden Sie unter Auslösen eines Ereignisses.
Die OnServerClick-Methode ermöglicht es auch abgeleiteten Klassen, das Ereignis ohne Anfügen eines Delegaten zu behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.
Hinweise für Erben Wenn Sie OnServerClick in einer abgeleiteten Klasse überschreiben, müssen Sie unbedingt die OnServerClick-Methode der Basisklasse aufrufen, sodass registrierte Delegaten das Ereignis empfangen.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie ein Handler für das ServerClick-Ereignis angegeben und codiert wird, um die Koordinaten zu bestimmen, an denen der Benutzer auf das HtmlInputImage-Steuerelement klickt.
<%@ Page Language="VB" AutoEventWireup="True" %>
<script runat="server">
Sub ImageBtn_Click(ByVal Sender As Object, ByVal E As ImageClickEventArgs)
' Write the click coordinates to the Span1 element.
Span1.InnerText = "You clicked at (" & E.X.ToString() & _
", " & E.Y.ToString() & ")."
End Sub
</script>
<html>
<body>
<form runat="server">
<h3>Click the Image </h3>
<input type="image"
alt="Image Alternate Text"
src="Image1.jpg"
OnServerClick="ImageBtn_Click"
runat="server"/>
<br />
<br />
<span id="Span1"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<script runat="server">
protected void ImageBtn_Click(object sender, ImageClickEventArgs e)
{
// Write the click coordinates to the Span1 element.
Span1.InnerText = "You clicked at (" + e.X.ToString() +
", " + e.Y.ToString() + ").";
}
</script>
<html>
<body>
<form runat="server">
<h3>Click the Image </h3>
<input type="image"
alt="Image Alternate Text"
src="Image1.jpg"
OnServerClick="ImageBtn_Click"
runat="server" id="Image1"/>
<br />
<br />
<span id="Span1"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<script language="JSCRIPT" runat=server>
function ImageBtn_Click(sender : Object, e : ImageClickEventArgs)
{
// Write the click coordinates to the Span1 element.
Span1.InnerText = "You clicked at (" + e.X.ToString()
+ ", " + e.Y.ToString() + ")."
}
</script>
<html>
<body>
<form id="Form1" runat="server">
<h3>Click the Image </h3>
<input type="image"
alt="Image Alternate Text"
src="Image1.jpg"
OnServerClick="ImageBtn_Click"
runat="server" id="Image1"/>
<br />
<br />
<span id="Span1"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<script runat="server">
Sub ImageBtn_Click(ByVal sender As Object, ByVal e As ImageClickEventArgs)
' Display the coordinates of the position where the image
' was clicked.
Span1.InnerText = "You clicked at (" & e.X.ToString() & _
", " & e.Y.ToString() & ")."
End Sub
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
' Create an EventHandler delegate for the method you want to
' handle the event, and then add it to the list of methods called
' when the event is raised.
AddHandler Image1.ServerClick, AddressOf ImageBtn_Click
End Sub
</script>
<html>
<body>
<form runat="server">
<h3>HtmlInputImage ServerClick Example </h3>
<input type="image"
id="Image1"
src="Image.jpg"
alt="Image"
runat="server"/>
<br>
<span id="Span1"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<script runat="server">
void ImageBtn_Click(Object sender, ImageClickEventArgs e)
{
// Display the coordinates of the position where the image
// was clicked.
Span1.InnerText = "You clicked at (" + e.X.ToString() +
", " + e.Y.ToString() + ").";
}
void Page_Load(Object sender, EventArgs e)
{
// Create an EventHandler delegate for the method you want to
// handle the event, and then add it to the list of methods called
// when the event is raised.
Image1.ServerClick += new ImageClickEventHandler(this.ImageBtn_Click);
}
</script>
<html>
<body>
<form runat="server">
<h3>HtmlInputImage ServerClick Example </h3>
<input type="image"
id="Image1"
src="Image.jpg"
alt="Image"
runat="server"/>
<br>
<span id="Span1"
runat="server"/>
</form>
</body>
</html>
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
HtmlInputImage-Klasse
HtmlInputImage-Member
System.Web.UI.HtmlControls-Namespace
ServerClick
System.Web.UI.ImageClickEventArgs