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
Наследование
PolygonHotSpot

Примеры

В следующем примере кода показано, как создать 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

Возвращает или задает индекс перехода по клавише 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)

Применяется к

См. также раздел