RectangleHotSpot Класс

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Определяет прямоугольную область горячей точки в элементе 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

Наследование: Object

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-адрес для перехода. Чтобы вернуться на сервер, задайте для свойства HotSpotMode.PostBack значение свойства и используйте PostBackValue его, чтобы указать имя объектаRectangleHotSpot.HotSpotMode Это имя будет передано в 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	Возвращает или задает индекс HotSpot табуляции региона. (Унаследовано от HotSpot)
Target	Возвращает или задает целевое окно или кадр, в котором отображается содержимое веб-страницы, связанное с HotSpot щелчком объекта, который переходит к URL-адресу. (Унаследовано от HotSpot)
Top	Возвращает или задает координату y верхней части прямоугольной области, определенной этим RectangleHotSpot объектом.
ViewState	Получает словарь сведений о состоянии, позволяющий сохранять и восстанавливать состояние HotSpot представления объекта в нескольких запросах на одну и ту же страницу. (Унаследовано от HotSpot)

Методы

Имя	Описание
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetCoordinates()	Возвращает строку, представляющую координаты RectangleHotSpot x -and y верхнего левого угла объекта, а также координаты 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)

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

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

Обратная связь

Были ли сведения на этой странице полезными?

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