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 свойство и используйте PostBackValue свойство, RectangleHotSpot чтобы HotSpotMode.PostBack указать имя объекта. Это имя будет передано в ImageMapEventArgs данных события при RectangleHotSpot щелчке. . Если требуетсяHotSpot, чтобы объект не имеет поведения, задайте для свойства значение HotSpotMode.InactiveHotSpotMode .

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

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)

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