HotSpotMode Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
public enum class HotSpotModepublic enum HotSpotModetype HotSpotMode = Public Enum HotSpotMode- Наследование
Поля
| Inactive | 3 | Объект HotSpot не характеризуется определенным поведением. |
| Navigate | 1 | Объект HotSpot выполняет переход по URL-адресу. |
| NotSet | 0 | Объект HotSpot реализует поведение, заданное в элементе управления ImageMap свойством HotSpotMode. Если в элементе управления ImageMap поведение не определено, объект HotSpot выполняет переход по URL-адресу. |
| PostBack | 2 | Объект HotSpot осуществляет обратную передачу на сервер. |
Примеры
В следующем примере кода показано, как использовать HotSpotMode значения перечисления для задания ImageMap.HotSpotMode свойства . Страница содержит элемент ImageMap управления, содержащий два RectangleHotSpot объекта . Свойству ImageMap.HotSpotMode присвоено значение HotSpotMode.PostBack, что приводит к тому, что страница будет отправлять данные на сервер каждый раз, когда пользователь щелкает один из регионов горячей точки. Свойство HotSpotMode не задано ни для того из объектов, RectangleHotSpot так как они получают свое поведение из ImageMap.HotSpotMode свойства . Чтобы этот пример работал правильно, необходимо указать собственный образ для ImageUrl свойства и соответствующим образом обновить путь к образу, чтобы приложение я ху хи хи.
<%@ page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void VoteMap_Clicked(object sender, ImageMapEventArgs e)
{
// When a user clicks the "Yes" hot spot,
// display the hot spot's value.
if (e.PostBackValue == "Yes")
Message1.Text = "You selected " + e.PostBackValue + ".";
else if (e.PostBackValue == "No")
// When a user clicks the "No" hot spot,
// display the hot spot's value.
Message1.Text = "You selected " + e.PostBackValue + ".";
else
Message1.Text = "You did not click a valid hot spot region.";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>ImageMap.HotSpotMode Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageMap.HotSpotMode Example</h3>
<!--The RectangleHotSpot objects have the post back
behavior specified by the HotSpotMode
property on the ImageMap control.-->
<asp:imagemap id="Vote"
imageurl="Images/VoteImage.jpg"
alternatetext="Voting choices"
hotspotmode="PostBack"
onclick="VoteMap_Clicked"
runat="Server">
<asp:RectangleHotSpot
top="0"
left="0"
bottom="354"
right="250"
postbackvalue="Yes"
alternatetext="Vote yes">
</asp:RectangleHotSpot>
<asp:RectangleHotSpot
top="0"
left="251"
bottom="354"
right="500"
postbackvalue="No"
alternatetext="Vote no">
</asp:RectangleHotSpot>
</asp:imagemap>
<br />
<asp:label id="Message1"
runat="Server">
</asp:label>
</form>
</body>
</html>
<%@ page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub VoteMap_Clicked(ByVal sender As Object, ByVal e As ImageMapEventArgs)
' When a user clicks the "Yes" hot spot,
' display the hot spot's value.
If (e.PostBackValue = "Yes") Then
Message1.Text = "You selected " & e.PostBackValue & "."
' When a user clicks the "No" hot spot,
' display the hot spot's value.
ElseIf (e.PostBackValue = "No") Then
Message1.Text = "You selected " & e.PostBackValue & "."
Else
Message1.Text = "You did not click a valid hot spot region."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>ImageMap.HotSpotMode Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageMap.HotSpotMode Example</h3>
<!--The RectangleHotSpot objects have the post back
behavior specified by the HotSpotMode
property on the ImageMap control.-->
<asp:imagemap id="Vote"
imageurl="Images/VoteImage.jpg"
alternatetext="Voting choices"
hotspotmode="PostBack"
onclick="VoteMap_Clicked"
runat="Server">
<asp:RectangleHotSpot
top="0"
left="0"
bottom="354"
right="250"
postbackvalue="Yes"
alternatetext="Vote yes">
</asp:RectangleHotSpot>
<asp:RectangleHotSpot
top="0"
left="251"
bottom="354"
right="500"
postbackvalue="No"
alternatetext="Vote no">
</asp:RectangleHotSpot>
</asp:imagemap>
<br />
<asp:label id="Message1"
runat="Server">
</asp:label>
</form>
</body>
</html>
Комментарии
Перечисление HotSpotMode представляет поведение, которое можно применить к объекту HotSpot в элементе ImageMap управления . Свойства ImageMap.HotSpotMode и HotSpot.HotSpotMode используют эти значения перечисления, чтобы задать поведение HotSpot объекта при его щелчке. Если заданы оба свойства, свойство, HotSpot.HotSpotMode указанное в каждом отдельном HotSpot объекте, имеет приоритет над свойством ImageMap.HotSpotMode в элементе управления .
Если указать HotSpotMode.NotSet для HotSpot.HotSpotMode свойства отдельного HotSpot объекта, HotSpot объект получает свое поведение из свойства содержащего ImageMap элемента управления ImageMap.HotSpotMode . В этом сценарии, если ImageMap свойство элемента управления HotSpotMode равно NotSet или значение не указано, по умолчанию используется переход по URL-адресу.
Примечание
ImageMap Если поведение элемента управления не указано с помощью ImageMap.HotSpotMode свойства или HotSpot.HotSpotMode свойства для HotSpot содержащихся в нем объектов, по умолчанию используется HotSpotMode.Navigateповедение . Кроме того, если HotSpot.HotSpotMode для свойств HotSpot объектов, содержащихся в ImageMap элементе управления, задано значение HotSpotMode.NotSet и для свойства не задано ImageMap.HotSpotMode значение , по умолчанию используется HotSpotMode.Navigateповедение .
Если указать HotSpotMode.Navigate для ImageMap.HotSpotMode свойства или HotSpot.HotSpotMode свойства, страница переходит по URL-адресу при щелчке HotSpot .
Image.NavigateUrl Используйте свойство или , HotSpot.NavigateUrl чтобы указать URL-адрес для перехода.
Если указать HotSpotMode.PostBack для ImageMap.HotSpotMode свойства или HotSpot.HotSpotMode свойства, страница создает обратную передачу на сервер при щелчке HotSpot .
PostBackValue Используйте свойство , чтобы указать имя объекта HotSpot . Это имя будет передано ImageMapEventArgs в данные события при возникновении события обратной передачи. При щелчке обратной HotSpot передачи Click возникает событие. Чтобы программно управлять действиями, выполняемыми при щелчке обратной передачи HotSpot , предоставьте обработчик Click события.
Если указать HotSpotMode.Inactive для HotSpot.HotSpotMode свойства , HotSpot объект не будет иметь никакого поведения при щелчке. Это значение можно использовать для создания неактивной горячей точки в более крупной активной горячей точке. Этот параметр позволяет создавать более сложные зоны горячей точки в элементе ImageMap управления.
Чтобы создать неактивную область в активной горячей точке, необходимо указать неактивную горячую точку перед активной в элементе ImageMap управления . Например, следующее ImageMap определяет активное кольцо, указывая неактивную круговую горячую точку в более крупной активной круговой горячей точке:
<asp:ImageMap ID="SaturnImage"
ImageUrl="~/saturn.PNG"
runat="server" OnClick="SaturnImage_Click">
<asp:CircleHotSpot AlternateText="planet" HotSpotMode=PostBack
PostBackValue="planet" Radius=40 X=100 Y=100 />
<asp:CircleHotSpot HotSpotMode=Inactive
Radius=60 X=100 Y=100 />
<asp:CircleHotSpot AlternateText="rings" HotSpotMode=PostBack
PostBackValue="rings" Radius=80 X=100 Y=100 />
</asp:ImageMap>
