HotSpotMode Перечисление

Определение

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

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

Важно!

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

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

public enum class HotSpotMode

public enum HotSpotMode

type HotSpotMode =

Public Enum HotSpotMode

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

ValueType

Enum
HotSpotMode

Поля

Имя	Значение	Описание
NotSet	0	Использует HotSpot поведение, заданное свойством ImageMap элемента управления HotSpotMode . ImageMap Если элемент управления не определяет поведение, HotSpot объект переходит по URL-адресу.
Navigate	1	Перемещается HotSpot по URL-адресу.
PostBack	2	Создает HotSpot обратную передачу на сервер.
Inactive	3	У HotSpot него нет никакого поведения.

Примеры

В следующем примере кода показано, как использовать HotSpotMode значения перечисления для задания ImageMap.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 управления. HotSpot.HotSpotMode Свойства ImageMap.HotSpotMode используют эти значения перечисленияHotSpot, чтобы задать поведение объекта при щелчке. Если заданы оба свойства, то свойство, указанное в каждом отдельном HotSpot объекте, HotSpot.HotSpotMode имеет приоритет над ImageMap.HotSpotMode свойством элемента управления.

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

Замечание

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

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

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

Если вы указываете HotSpotMode.Inactive для свойства, HotSpot объект не имеет никакого HotSpot.HotSpotMode поведения при щелчке. Это значение можно использовать для создания неактивной горячей точки в более активной горячей точке. Этот параметр позволяет создавать более сложные зоны горячей точки в элементе 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>

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

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

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

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

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