Декларативный синтаксис серверного веб-элемента управления ImageButton
Обновлен: Ноябрь 2007
Позволяет обрабатывать щелчки мышью изображения, обеспечивая функции, схожие с теми, которыми обладает карта изображений.
<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"
/>
Заметки
Элемент управления ImageButton используется для отображения изображения, реагирующего на нажатия клавиш мыши. Задайте изображение, отображаемое в элементе управления, указывается с помощью свойства ImageUrl.
Оба события — и Click, и Command возникают при щелчке мышью элемента управления ImageButton.
Использование обработчика событий OnClick позволяет программно определить координаты точки изображения, где производится щелчок мышью. Это позволяет запрограммировать ответ на основе значений этих координат. Обратите внимание, что начало координат (0, 0) находится в левом верхнем углу изображения.
Обработчик событий OnCommand используется для того, чтобы элемент управления ImageButton функционировал как кнопка. Свойство CommandName используется для того, чтобы связать имя команды с элементом управления. Это позволяет разместить несколько элементов управления ImageButton на одной веб-странице. Значение свойства CommandName может быть использовано программным образом в обработчике событий OnCommand для определения соответствующих действий, которые необходимо выполнить при нажатии на кнопку каждого из элементов управления ImageButton. Свойство CommandArgument может также использоваться для передачи дополнительной информации о команде, например, можно задать порядок по возрастанию.
.gif "Примечание") Примечание. |
|---|
Поскольку элемент <asp:ImageButton> не имеет содержимого, можно закрыть тег с помощью /> вместо использования отдельного закрывающего тега. |
По умолчанию проверка страницы выполняется при щелчке элемента управления ImageButton. Проверка страниц определяет, передают ли элементы управления вводом, связанные с элементом управления на странице, правила проверки, заданные элементом управления проверкой. Если имеется элемент управления ImageButton, для которого необходимо запретить это поведение (например, кнопка reset), то для свойства CausesValidation следует установить значение false.
Подробные сведения о свойствах и событиях серверного веб-элемента управления ImageButton см. в документации по классу ImageButton.
Пример
Следующий пример демонстрирует, как с помощью элемента управления ImageButton отобразить координаты указателя мыши в момент щелчка изображения.
| Примечание. |
|---|
В следующем примере кода используется однофайловая модель кода. Если скопировать его в файл кода программной части, он может работать неправильно. Этот пример кода необходимо скопировать в пустой текстовый файл с расширением ASPX. Дополнительные сведения о модели кода веб-форм см. в разделе Модель кода веб-страниц 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>
См. также
Ссылки
Декларативный синтаксис серверного веб-элемента управления Button