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-адресу, присвойте свойству HotSpotModeHotSpotMode.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 |
Возвращает или задает индекс перехода по клавише TAB для области 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) |