ImageMap.HotSpotMode Свойство

  • Ссылка

Определение

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

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

public:
 virtual property System::Web::UI::WebControls::HotSpotMode HotSpotMode { System::Web::UI::WebControls::HotSpotMode get(); void set(System::Web::UI::WebControls::HotSpotMode value); };
public virtual System.Web.UI.WebControls.HotSpotMode HotSpotMode { get; set; }
member this.HotSpotMode : System.Web.UI.WebControls.HotSpotMode with get, set
Public Overridable Property HotSpotMode As HotSpotMode

Значение свойства

HotSpotMode

Одно из значений перечисления HotSpotMode. Значение по умолчанию — NotSet.

Исключения

ArgumentOutOfRangeException

Указанный тип не является одним из значений перечисления HotSpotMode.

Примеры

В следующем примере кода показано, как декларативно создать ImageMap элемент управления, содержащий два RectangleHotSpot объекта . Свойству ImageMap.HotSpotMode присваивается значение HotSpotMode.PostBack, что приводит к тому, что страница отправляется обратно на сервер каждый раз, когда пользователь щелкает один из регионов горячей точки. Свойство HotSpotMode не задано для каждого из объектов , RectangleHotSpot так как они получают свое поведение из ImageMap.HotSpotMode свойства . Чтобы этот пример работал правильно, необходимо указать собственный образ для 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)
  {       
    // When a user clicks the "Yes" hot spot,
    // display the hot spot's value.
    if (e.PostBackValue == "Yes")
      Message1.Text = "You selected " + e.PostBackValue + ".";
       
    else if (e.PostBackValue == "No") 
      // When a user clicks the "No" hot spot,
      // display the hot spot's value.       
      Message1.Text = "You selected " + e.PostBackValue + ".";
      
    else
      Message1.Text = "You did not click a valid hot spot region.";             
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageMap.HotSpotMode Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>ImageMap.HotSpotMode Example</h3>
      
      <!--The RectangleHotSpot objects have the post back
        behavior specified by the HotSpotMode 
        property on the ImageMap control.-->
      <asp:imagemap id="Vote"           
        imageurl="Images/VoteImage.jpg"
        alternatetext="Voting choices" 
        hotspotmode="PostBack"
        onclick="VoteMap_Clicked"   
        runat="Server">   
        
        <asp:RectangleHotSpot          
          top="0"
          left="0"
          bottom="354"
          right="250"
          postbackvalue="Yes"
          alternatetext="Vote yes">
        </asp:RectangleHotSpot>
        
        <asp:RectangleHotSpot 
          top="0"
          left="251"
          bottom="354"
          right="500"
          postbackvalue="No"
          alternatetext="Vote no">
        </asp:RectangleHotSpot>
        
      </asp:imagemap>
      
      <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)
            
    ' When a user clicks the "Yes" hot spot,
    ' display the hot spot's value.
    If (e.PostBackValue = "Yes") Then
      Message1.Text = "You selected " & e.PostBackValue & "."
       
      ' When a user clicks the "No" hot spot,
      ' display the hot spot's value.
    ElseIf (e.PostBackValue = "No") Then
      Message1.Text = "You selected " & e.PostBackValue & "."
      
    Else
      Message1.Text = "You did not click a valid hot spot region."
                
    End If
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageMap.HotSpotMode Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>ImageMap.HotSpotMode Example</h3>
      
      <!--The RectangleHotSpot objects have the post back
        behavior specified by the HotSpotMode 
        property on the ImageMap control.-->
      <asp:imagemap id="Vote"           
        imageurl="Images/VoteImage.jpg"
        alternatetext="Voting choices" 
        hotspotmode="PostBack"
        onclick="VoteMap_Clicked"   
        runat="Server">   
        
        <asp:RectangleHotSpot          
          top="0"
          left="0"
          bottom="354"
          right="250"
          postbackvalue="Yes"
          alternatetext="Vote yes">
        </asp:RectangleHotSpot>
        
        <asp:RectangleHotSpot 
          top="0"
          left="251"
          bottom="354"
          right="500"
          postbackvalue="No"
          alternatetext="Vote no">
        </asp:RectangleHotSpot>
        
      </asp:imagemap>
      
      <br />
      
      <asp:label id="Message1"
        runat="Server">
      </asp:label>
              
    </form>      
  </body>
</html>

Комментарии

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

Элемент Описание
Inactive Объект HotSpot не имеет никакого поведения.
NotSet Объект HotSpot использует поведение, заданное свойством ImageMapHotSpotMode элемента управления. ImageMap Если элемент управления не определяет поведение, HotSpot все объекты переходить по URL-адресу.
Navigate Объекты HotSpot переходит по URL-адресу.
PostBack Объекты HotSpot создают обратную передачу на сервер.

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

При установке HotSpotMode свойства ImageMap элемента управления обратите внимание, что HotSpotMode.NotSet значения и HotSpotMode.Navigate имеют одинаковое поведение: оба переходить по URL-адресу. При указании HotSpotMode.NotSetHotSpot.HotSpotMode для свойства отдельного HotSpot объекта определяет HotSpot его поведение на основе значения HotSpotMode свойства ImageMap элемента управления .

Если указать HotSpotMode.Navigate для ImageMap.HotSpotMode свойства , страница переходит по URL-адресу при щелчке HotSpot . Используйте свойство , NavigateUrl чтобы указать URL-адрес для перехода.

Если указать HotSpotMode.PostBack для ImageMap.HotSpotMode свойства , страница создает обратную передачу на сервер при щелчке HotSpot . Используйте свойство , PostBackValue чтобы указать имя региона горячей точки. Это имя будет передано ImageMapEventArgs в данные события при возникновении события обратной передачи. При нажатии кнопки обратной передачи HotSpotClick возникает событие. Чтобы программно управлять действиями, выполняемыми при щелчке обратной передачи HotSpot , предоставьте обработчик Click события.

Если указать HotSpotMode.Inactive для HotSpot.HotSpotMode свойства , HotSpot объект не будет иметь никакого поведения при щелчке. Это значение можно использовать для создания неактивной горячей точки в более крупной активной горячей точке. Этот параметр предоставляется для создания более сложных зон горячих точечной точки в элементе ImageMap управления.

Чтобы создать неактивную область в активной горячей точке, необходимо указать неактивную горячую точку перед активной горячей точкой в элементе ImageMap управления . Например, следующий ImageMap код определяет активное кольцо, указывая неактивную круговую горячую точку в более крупной активной круговой горячей точке:

<asp:ImageMap ID="SaturnImage"   
       ImageUrl="~/saturn.PNG"   
       runat="server" OnClick="SaturnImage_Click">  
    <asp:CircleHotSpot AlternateText="planet" HotSpotMode=PostBack  
          PostBackValue="planet" Radius=40 X=100 Y=100 />  

    <asp:CircleHotSpot HotSpotMode=Inactive   
          Radius=60 X=100 Y=100 />  
    <asp:CircleHotSpot AlternateText="rings" HotSpotMode=PostBack  
          PostBackValue="rings" Radius=80 X=100 Y=100 />  
</asp:ImageMap>

Чтобы все HotSpot объекты в элементе ImageMap управления имели одинаковое поведение, используйте HotSpotMode свойство элемента управления для ImageMap указания поведения. Затем присвойте свойству HotSpotMode для каждого отдельного HotSpot объекта HotSpotMode.NotSet значение или не указывайте значение для HotSpot.HotSpotMode свойства.

Чтобы указать различные варианты поведения для HotSpot объектов в элементе ImageMapHotSpot.HotSpotMode управления, задайте для свойства каждого отдельного HotSpot объекта HotSpotMode.Navigateзначение , HotSpotMode.PostBackили HotSpotMode.Inactive.

Примечание

Если свойству ImageMap элемента управления ImageMap.HotSpotMode или свойству HotSpot.HotSpotMode любого из HotSpot содержащихся в нем объектов задано HotSpotMode.NotSet значение или не задано значение, по умолчанию поведение равно HotSpotMode.Navigate.

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

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