Syntaxe déclarative du contrôle serveur Web ImageButton
Mise à jour : novembre 2007
Permet de gérer les clics utilisateur dans une image ; fonctionnalité analogue à celle des images interactives.
<asp:ImageButton
AccessKey="string"
AlternateText="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CausesValidation="True|False"
CommandArgument="string"
CommandName="string"
CssClass="string"
DescriptionUrl="uri"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
ImageAlign="NotSet|Left|Right|Baseline|Top|Middle|Bottom|
AbsBottom|AbsMiddle|TextTop"
ImageUrl="uri"
OnClick="Click event handler"
OnClientClick="string"
OnCommand="Command event handler"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
PostBackUrl="uri"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
/>
Notes
Utilisez le contrôle ImageButton pour afficher une image qui répond à des clics de souris. Spécifiez l'image à afficher dans le contrôle en définissant la propriété ImageUrl.
Les deux événements Click et Command sont déclenchés à la suite d'un clic sur le contrôle ImageButton.
En utilisant le gestionnaire d'événements OnClick, vous pouvez déterminer par programme les coordonnées du point où un clic est effectué dans l'image. Vous pouvez alors coder une réponse à partir des valeurs des coordonnées. Notez que l'origine (0, 0) correspond au coin supérieur gauche de l'image.
Vous pouvez utiliser le gestionnaire d'événements OnCommand pour faire en sorte que le contrôle ImageButton se comporte comme un bouton de commande. Un nom de commande peut être associé au contrôle en utilisant la propriété CommandName. Cela permet de placer plusieurs contrôles ImageButton sur la même page Web. La valeur de la propriété CommandName peut ensuite être identifiée par programme dans le gestionnaire d'événements OnCommand pour déterminer l'action appropriée à effectuer à la suite d'un clic sur chaque contrôle ImageButton. La propriété CommandArgument peut également être utilisée pour passer des informations supplémentaires sur la commande, telle la spécification de l'ordre croissant.
.gif "Remarque") Remarque : |
|---|
Dans la mesure où l'élément <asp:ImageButton> n'a pas de contenu, vous pouvez fermer la balise avec /> au lieu d'une balise de fermeture distincte. |
Par défaut, la validation de la page est effectuée lors d'un clic sur un contrôle ImageButton. La validation de la page détermine si les contrôles d'entrée associés à un contrôle de validation passent avec succès les règles de validation spécifiées par le contrôle de validation. Si vous possédez un contrôle ImageButton qui doit désactiver ce comportement, par exemple un bouton reset, affectez à la propriété CausesValidation la valeur false.
Pour plus d'informations sur les propriétés et événements du contrôle serveur Web ImageButton, consultez la documentation de la classe ImageButton.
Exemple
Le code suivant montre comment utiliser un contrôle ImageButton pour afficher les coordonnées du pointeur de la souris lors d'un clic dans l'image.
| Remarque : |
|---|
L'exemple de code suivant utilise le modèle de code à fichier unique ; il est possible qu'il ne fonctionne pas correctement s'il est directement copié dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide doté d'une extension .aspx. Pour plus d'informations sur le modèle de code Web Forms, consultez Modèle de code des pages Web ASP.NET. |
<%@ 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>
<%@ 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="JScript" 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="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>
Voir aussi
Référence
Syntaxe déclarative du contrôle serveur Web Button