PolygonHotSpot Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет многоугольниковую область горячей точки в элементе ImageMap управления. Этот класс не может быть унаследован.
public ref class PolygonHotSpot sealed : System::Web::UI::WebControls::HotSpot
public sealed class PolygonHotSpot : System.Web.UI.WebControls.HotSpot
type PolygonHotSpot = class
inherit HotSpot
Public NotInheritable Class PolygonHotSpot
Inherits HotSpot
- Наследование
Примеры
В следующем примере кода показано, как создать ImageMap элемент управления, содержащий три PolygonHotSpot объекта. Каждый PolygonHotSpot объект представляет географический регион на карте. Когда пользователь щелкает PolygonHotSpot объект, он отправляет данные обратно на сервер, а тип и имя горячей точки отображаются в метке.
<%@ 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 RegionMap_Clicked (object sender, ImageMapEventArgs e)
{
string hotSpotType;
// When a user clicks a hot spot, display
// the hot spot's type and name.
switch (e.PostBackValue)
{
case "Western":
hotSpotType = Regions.HotSpots[0].ToString();
Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue;
break;
case "Northern":
hotSpotType = Regions.HotSpots[1].ToString();
Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue;
break;
case "Southern":
hotSpotType = Regions.HotSpots[2].ToString();
Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue;
break;
default:
Message1.Text = "You did not click a valid hot spot region.";
break;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>PolygonHotSpot Class Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>PolygonHotSpot Example</h3>
<!-- Change or remove the width and height attributes as
appropriate for your image. -->
<asp:imagemap id="Regions"
imageurl="Images/RegionMap.jpg"
alternatetext="Sales regions"
hotspotmode="PostBack"
width="400"
height="400"
onclick="RegionMap_Clicked"
runat="Server">
<asp:PolygonHotSpot
coordinates="0,0,176,0,125,182,227,400,0,400"
postbackvalue="Western"
alternatetext="Western Region">
</asp:PolygonHotSpot>
<asp:PolygonHotSpot
coordinates="177,0,400,0,400,223,335,154,127,180"
postbackvalue="Northern"
alternatetext="Northern Region">
</asp:PolygonHotSpot>
<asp:PolygonHotSpot
coordinates="128,185,335,157,400,224,400,400,228,400"
postbackvalue="Southern"
alternatetext="Southern Region">
</asp:PolygonHotSpot>
</asp:imagemap>
<br /><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 RegionMap_Clicked(ByVal sender As Object, ByVal e As ImageMapEventArgs)
Dim hotSpotType As String
' When a user clicks a hot spot, display
' the hot spot's type and name.
Select Case (e.PostBackValue)
Case ("Western")
hotSpotType = Regions.HotSpots(0).ToString()
Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue
Case ("Northern")
hotSpotType = Regions.HotSpots(1).ToString()
Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue
Case ("Southern")
hotSpotType = Regions.HotSpots(2).ToString()
Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue
Case Else
Message1.Text = "You did not click a valid hot spot region."
End Select
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>PolygonHotSpot Class Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>PolygonHotSpot Example</h3>
<!-- Change or remove the width and height attributes as
appropriate for your image. -->
<asp:imagemap id="Regions"
imageurl="Images/RegionMap.jpg"
alternatetext="Sales regions"
hotspotmode="PostBack"
width="400"
height="400"
onclick="RegionMap_Clicked"
runat="Server">
<asp:PolygonHotSpot
coordinates="0,0,176,0,125,182,227,400,0,400"
postbackvalue="Western"
alternatetext="Western Region">
</asp:PolygonHotSpot>
<asp:PolygonHotSpot
coordinates="177,0,400,0,400,223,335,154,127,180"
postbackvalue="Northern"
alternatetext="Northern Region">
</asp:PolygonHotSpot>
<asp:PolygonHotSpot
coordinates="128,185,335,157,400,224,400,400,228,400"
postbackvalue="Southern"
alternatetext="Southern Region">
</asp:PolygonHotSpot>
</asp:imagemap>
<br /><br />
<asp:label id="Message1"
runat="Server">
</asp:label>
</form>
</body>
</html>
Комментарии
Этот класс определяет многоугольниковую область горячей точки в элементе ImageMap управления. Это PolygonHotSpot полезно для определения нерегулярных областей горячей точки в элементе ImageMap управления. Например, его можно использовать для определения отдельных регионов в географической карте.
Чтобы определить область PolygonHotSpotобъекта, задайте Coordinates для свойства строку, указывающую координаты каждой PolygonHotSpot вершины объекта. Вершина многоугольника — это точка, в которой встречаются два края многоугольника.
PolygonHotSpot Когда объект щелкается, страница переходит по URL-адресу, создает запись обратно на сервер или ничего не делает. Свойство HotSpotMode указывает это поведение. Чтобы перейти к URL-адресу, задайте HotSpotMode для свойства HotSpotMode.Navigateзначение и используйте NavigateUrl свойство, чтобы указать URL-адрес для перехода. Чтобы вернуться на сервер, задайте HotSpotMode для свойства HotSpotMode.PostBackзначение и используйте PostBackValue свойство, чтобы указать имя объекта PolygonHotSpot . Это имя будет передано в ImageMapEventArgs данных события при PolygonHotSpot щелчке.
PolygonHotSpot Если объект не имеет поведения, задайте HotSpotMode для свойства значение HotSpotMode.Inactive.
Конструкторы
| Имя | Описание |
|---|---|
| PolygonHotSpot() |
Инициализирует новый экземпляр класса PolygonHotSpot. |
Свойства
| Имя | Описание |
|---|---|
| AccessKey |
Получает или задает ключ доступа, позволяющий быстро перейти в HotSpot регион. (Унаследовано от HotSpot) |
| AlternateText |
Получает или задает альтернативный текст, отображаемый для HotSpot объекта в элементе ImageMap управления, если изображение недоступно или отрисовывается в браузере, который не поддерживает изображения. (Унаследовано от HotSpot) |
| Coordinates |
Строка координат, представляющая вершины PolygonHotSpot объекта. |
| HotSpotMode |
Возвращает или задает поведение HotSpot объекта в элементе ImageMap управления при HotSpot щелчке. (Унаследовано от HotSpot) |
| IsTrackingViewState |
Возвращает значение, указывающее, отслеживает ли HotSpot объект изменения состояния представления. (Унаследовано от HotSpot) |
| MarkupName |
При переопределении в производном классе получает строковое представление фигуры HotSpot объекта. (Унаследовано от HotSpot) |
| NavigateUrl |
Возвращает или задает URL-адрес для перехода по щелчку HotSpot объекта. (Унаследовано от HotSpot) |
| PostBackValue |
Возвращает или задает имя HotSpot объекта, передаваемого в данные события при HotSpot щелчке. (Унаследовано от HotSpot) |
| TabIndex |
Возвращает или задает индекс HotSpot табуляции региона. (Унаследовано от HotSpot) |
| Target |
Возвращает или задает целевое окно или кадр, в котором отображается содержимое веб-страницы, связанное с HotSpot щелчком объекта, который переходит к URL-адресу. (Унаследовано от HotSpot) |
| ViewState |
Получает словарь сведений о состоянии, позволяющий сохранять и восстанавливать состояние HotSpot представления объекта в нескольких запросах на одну и ту же страницу. (Унаследовано от HotSpot) |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetCoordinates() |
Возвращает строку, представляющую координаты PolygonHotSpot вершин объекта. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| LoadViewState(Object) |
Восстанавливает HotSpot ранее сохраненное состояние представления объекта в объект. (Унаследовано от HotSpot) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| SaveViewState() |
Сохраняет изменения HotSpot состояния представления объекта с момента публикации страницы на сервер. (Унаследовано от HotSpot) |
| ToString() |
String Возвращает представление этого экземпляра HotSpot объекта. (Унаследовано от HotSpot) |
| TrackViewState() |
Позволяет HotSpot объекту отслеживать изменения состояния представления, чтобы они могли храниться в объекте объекта StateBag . Этот объект доступен через ViewState свойство. (Унаследовано от HotSpot) |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| IStateManager.IsTrackingViewState |
Возвращает значение, указывающее, отслеживает ли HotSpot объект изменения состояния представления. (Унаследовано от HotSpot) |
| IStateManager.LoadViewState(Object) |
Восстанавливает HotSpot ранее сохраненное состояние представления объекта в объект. (Унаследовано от HotSpot) |
| IStateManager.SaveViewState() |
Сохраняет изменения HotSpot состояния представления объекта с момента последнего размещения страницы на сервере. (Унаследовано от HotSpot) |
| IStateManager.TrackViewState() |
Указывает HotSpot региону отслеживать изменения состояния представления. (Унаследовано от HotSpot) |