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

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

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

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

При указании HotSpotMode.PostBack свойства ImageMap.HotSpotMode страница создает обратную передачу на сервер при HotSpot щелчке. PostBackValue Используйте свойство, чтобы указать имя области горячей точки. Это имя будет передано в 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>

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

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

Замечание

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

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

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

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

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

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