Поделиться через


RectangleHotSpot Класс

Определение

Определяет прямоугольную активную область для указателя мыши в элементе управления ImageMap. Этот класс не наследуется.

public ref class RectangleHotSpot sealed : System::Web::UI::WebControls::HotSpot
public sealed class RectangleHotSpot : System.Web.UI.WebControls.HotSpot
type RectangleHotSpot = class
    inherit HotSpot
Public NotInheritable Class RectangleHotSpot
Inherits HotSpot
Наследование
RectangleHotSpot

Примеры

В следующем примере кода показано, как декларативно создать ImageMap элемент управления, содержащий два RectangleHotSpot объекта . Свойству ImageMap.HotSpotMode присвоено значение HotSpotMode.PostBack, что приводит к тому, что страница будет отправлять данные на сервер каждый раз, когда пользователь щелкает один из регионов горячей точки. Каждый раз, когда пользователь щелкает один из RectangleHotSpot объектов, GetCoordinates вызывается метод и отображаются координаты выбранной горячей точки для пользователя. Чтобы этот пример работал правильно, необходимо указать собственный образ для 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)
  {
    string coordinates;
    string hotSpotType;
    int yescount = ((ViewState["yescount"] != null)? (int)ViewState["yescount"] : 0);
    int nocount = ((ViewState["nocount"] != null)? (int)ViewState["nocount"] : 0);

    // When a user clicks the "Yes" hot spot,
    // display the hot spot's name and coordinates.
    if (e.PostBackValue.Contains("Yes"))
    {
      yescount += 1;
      coordinates = Vote.HotSpots[0].GetCoordinates();
      hotSpotType = Vote.HotSpots[0].ToString ();
      Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue + ".<br />" +
                      "The coordinates are " + coordinates + ".<br />" +
                      "The current vote count is " + yescount.ToString() + 
            " yes votes and " + nocount.ToString() + " no votes.";
    }
      
    // When a user clicks the "No" hot spot,
    // display the hot spot's name and coordinates.
    else if (e.PostBackValue.Contains("No"))
    {
      nocount += 1;
      coordinates = Vote.HotSpots[1].GetCoordinates();
      hotSpotType = Vote.HotSpots[1].ToString ();
      Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue + ".<br />" +
                      "The coordinates are " + coordinates + ".<br />" +
            "The current vote count is " + yescount.ToString() +
            " yes votes and " + nocount.ToString() + " no votes.";
    }
    
    else
    {
      Message1.Text = "You did not click a valid hot spot region.";
    }

    ViewState["yescount"] = yescount;
    ViewState["nocount"] = nocount;
  }           
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageMap Class Post Back Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>ImageMap Class Post Back Example</h3>
      
      <asp:imagemap id="Vote"           
        imageurl="Images/VoteImage.jpg"
        width="400" 
        height="200" 
        alternatetext="Vote Yes or No"
        hotspotmode="PostBack"
        onclick="VoteMap_Clicked"
        runat="Server">            
          
        <asp:RectangleHotSpot          
          top="0"
          left="0"
          bottom="200"
          right="200"
          postbackvalue="Yes"
          alternatetext="Vote yes">
        </asp:RectangleHotSpot>
          
        <asp:RectangleHotSpot 
          top="0"
          left="201"
          bottom="200"
          right="400"
          postbackvalue="No"
          alternatetext="Vote no">
        </asp:RectangleHotSpot>
      
      </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 VoteMap_Clicked(ByVal sender As Object, ByVal e As ImageMapEventArgs)
    Dim coordinates As String
    Dim hotSpotType As String
    Dim yescount As Integer
    Dim nocount As Integer
    
    If (ViewState("yescount") IsNot Nothing) Then
      yescount = Convert.ToInt32(ViewState("yescount"))
    Else
      yescount = 0
    End If
    If (ViewState("nocount") IsNot Nothing) Then
      nocount = Convert.ToInt32(ViewState("nocount"))
    Else
      nocount = 0
    End If
      
    
    ' When a user clicks the "Yes" hot spot,
    ' display the hot spot's name and coordinates.
    If (e.PostBackValue.Contains("Yes")) Then
      
      yescount += 1
      coordinates = Vote.HotSpots(0).GetCoordinates()
      hotSpotType = Vote.HotSpots(0).ToString()
      Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue & ".<br />" & _
                      "The coordinates are " & coordinates & ".<br />" & _
                      "The current vote count is " & yescount.ToString() & _
                      " yes votes and " & nocount.ToString() & " no votes."
       
      ' When a user clicks the "No" hot spot,
      ' display the hot spot's name and coordinates.
    ElseIf (e.PostBackValue.Contains("No")) Then
      
      nocount += 1
      coordinates = Vote.HotSpots.Item(1).GetCoordinates()
      hotSpotType = Vote.HotSpots.Item(1).ToString()
      Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue & ".<br />" & _
                     "The coordinates are " & coordinates & ".<br />" & _
                      "The current vote count is " & yescount.ToString() & _
                      " yes votes and " & nocount.ToString() & " no votes."
      
    Else
      
      Message1.Text = "You did not click a valid hot spot region."
                
    End If
      
    ViewState("yescount") = yescount
    ViewState("nocount") = nocount
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageMap Class Post Back Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>ImageMap Class Post Back Example</h3>
      
      <asp:imagemap id="Vote"           
        imageurl="Images/VoteImage.jpg"
        width="400" 
        height="200" 
        alternatetext="Vote Yes or No"
        hotspotmode="PostBack"
        onclick="VoteMap_Clicked"
        runat="Server">            
          
        <asp:RectangleHotSpot          
          top="0"
          left="0"
          bottom="200"
          right="200"
          postbackvalue="Yes"
          alternatetext="Vote yes">
        </asp:RectangleHotSpot>
          
        <asp:RectangleHotSpot 
          top="0"
          left="201"
          bottom="200"
          right="400"
          postbackvalue="No"
          alternatetext="Vote no">
        </asp:RectangleHotSpot>
      
      </asp:imagemap>
            
      <br /><br />
          
      <asp:label id="Message1"
        runat="Server">
      </asp:label>                 
                 
    </form>      
  </body>
</html>

Комментарии

Этот класс определяет прямоугольную область горячей точки в элементе ImageMap управления . Чтобы определить область RectangleHotSpot объекта, присвойте Left свойству значение, представляющее координату X верхнего левого угла прямоугольной области. Присвойте Top свойству значение, представляющее координату Y верхнего левого угла прямоугольной области. Присвойте Right свойству значение, представляющее координату X правого нижнего угла прямоугольной области. Bottom Задайте для свойства значение, представляющее координату Y правого нижнего угла прямоугольной области.

При щелчке RectangleHotSpot элемента управления страница переходит по URL-адресу, создает запись обратно на сервер или ничего не делает. Это HotSpotMode поведение определяется свойством . Чтобы перейти к URL-адресу, задайте свойству HotSpotMode значение HotSpotMode.Navigate и используйте NavigateUrl свойство , чтобы указать URL-адрес для перехода. Чтобы выполнить обратную отправку на сервер, присвойте свойству HotSpotModePostBackValue значение HotSpotMode.PostBack и используйте свойство , чтобы указать имя объекта RectangleHotSpot . Это имя будет передано ImageMapEventArgs в данные события при щелчке RectangleHotSpot . . Если требуется HotSpot , чтобы у объекта не было поведения, присвойте свойству HotSpotMode значение HotSpotMode.Inactive.

Конструкторы

RectangleHotSpot()

Инициализирует новый экземпляр класса RectangleHotSpot.

Свойства

AccessKey

Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к области HotSpot.

(Унаследовано от HotSpot)
AlternateText

Возвращает или задает альтернативный текст, отображаемый для объекта HotSpot в элементе управления ImageMap в случае недоступности изображения или отрисовки для просмотра в браузере, не поддерживающем изображения.

(Унаследовано от HotSpot)
Bottom

Получает или задает координату y нижней стороны прямоугольной зоны, определяемой данным объектом RectangleHotSpot.

HotSpotMode

Возвращает или задает поведение объекта HotSpot в элементе управления ImageMap при щелчке HotSpot.

(Унаследовано от HotSpot)
IsTrackingViewState

Получает значение, указывающее, отслеживает ли объект HotSpot изменения в данных о своем состоянии представления.

(Унаследовано от HotSpot)
Left

Получает или задает координату x левой границы прямоугольной зоны, определяемой данным объектом RectangleHotSpot.

MarkupName

При переопределении в производном классе возвращает строковое представление для фигуры объекта HotSpot.

(Унаследовано от HotSpot)
NavigateUrl

Возвращает или задает URL-адрес для перехода при щелчке объекта HotSpot.

(Унаследовано от HotSpot)
PostBackValue

Возвращает или задает имя объекта HotSpot, передаваемое в связанных с событием данных при щелчке объекта HotSpot.

(Унаследовано от HotSpot)
Right

Получает или задает координату x правой границы прямоугольной зоны, определяемой данным объектом RectangleHotSpot.

TabIndex

Возвращает или задает индекс перехода по клавише TAB для области HotSpot.

(Унаследовано от HotSpot)
Target

Возвращает или задает целевое окно или фрейм, в которых отображается содержимое веб-страницы, на которую указывает ссылка, при щелчке объекта HotSpot, осуществляющего переход по заданному URL-адресу.

(Унаследовано от HotSpot)
Top

Получает или задает координату y верхней границы прямоугольной зоны, определяемой данным объектом RectangleHotSpot.

ViewState

Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления объекта HotSpot при нескольких запросах одной и той же страницы.

(Унаследовано от HotSpot)

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetCoordinates()

Возвращает строку, представляющую координаты x и y верхнего левого угла объекта RectangleHotSpot и координаты x и y его нижнего правого угла.

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)

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

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