HotSpotMode Enum

Definisi

Menentukan perilaku HotSpot objek dalam ImageMap kontrol saat HotSpot diklik.

public enum class HotSpotMode
public enum HotSpotMode
type HotSpotMode = 
Public Enum HotSpotMode
Warisan
HotSpotMode

Bidang

Inactive 3

HotSpot tidak memiliki perilaku apa pun.

Navigate 1

Menavigasi HotSpot ke URL.

NotSet 0

HotSpot menggunakan perilaku yang diatur oleh ImageMap properti kontrolHotSpotMode. ImageMap Jika kontrol tidak menentukan perilaku, HotSpot objek akan menavigasi ke URL.

PostBack 2

HotSpot menghasilkan postback ke server.

Contoh

Contoh kode berikut menunjukkan cara menggunakan HotSpotMode nilai enumerasi untuk mengatur ImageMap.HotSpotMode properti . Halaman berisi ImageMap kontrol yang berisi dua RectangleHotSpot objek. Properti ImageMap.HotSpotMode diatur ke HotSpotMode.PostBack, yang menyebabkan halaman memposting kembali ke server setiap kali pengguna mengklik salah satu wilayah hot spot. Properti HotSpotMode tidak diatur pada salah RectangleHotSpot satu objek karena mereka mendapatkan perilakunya dari ImageMap.HotSpotMode properti . Agar contoh ini berfungsi dengan benar, Anda harus menyediakan gambar Anda sendiri untuk ImageUrl properti dan memperbarui jalur ke gambar dengan tepat sehingga aplikasi dapat menemukannya.

<%@ 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>

Keterangan

Enumerasi HotSpotMode mewakili perilaku yang dapat Anda terapkan HotSpot ke objek dalam ImageMap kontrol. properti ImageMap.HotSpotMode dan HotSpot.HotSpotMode menggunakan nilai enumerasi ini untuk mengatur perilaku HotSpot objek saat diklik. Jika kedua properti diatur, HotSpot.HotSpotMode properti yang ditentukan pada setiap objek individu HotSpot lebih diutamakan daripada ImageMap.HotSpotMode properti pada kontrol.

Jika Anda menentukan HotSpotMode.NotSet untuk HotSpot.HotSpotMode properti objek individualHotSpot, mendapatkan HotSpot perilakunya dari properti kontrol ImageMap.HotSpotMode yang berisiImageMap. Dalam skenario ini, jika ImageMap properti kontrol HotSpotMode ditentukan NotSet atau tidak ada nilai, perilaku defaultnya adalah menavigasi ke URL.

Catatan

Jika perilaku kontrol tidak ditentukan menggunakan properti atau HotSpot.HotSpotMode properti pada objek yang ImageMap dikandungnyaHotSpot, secara default perilakunya adalah HotSpotMode.Navigate.ImageMap.HotSpotMode Selain itu, jika HotSpot.HotSpotMode properti pada HotSpot objek yang ImageMap dikandung kontrol diatur ke HotSpotMode.NotSet dan tidak ada nilai yang ditentukan untuk ImageMap.HotSpotMode properti , perilaku defaultnya adalah HotSpotMode.Navigate.

Jika Anda menentukan HotSpotMode.Navigate untuk properti atau HotSpot.HotSpotMode properti , halaman menavigasi ke URL saat diklik HotSpotImageMap.HotSpotMode. Image.NavigateUrl Gunakan properti atau HotSpot.NavigateUrl untuk menentukan URL yang akan dinavigasi.

Jika Anda menentukan HotSpotMode.PostBack untuk ImageMap.HotSpotMode properti atau HotSpot.HotSpotMode properti , halaman menghasilkan postback ke server saat HotSpot diklik. PostBackValue Gunakan properti untuk menentukan nama untuk HotSpot objek. Nama ini akan diteruskan dalam ImageMapEventArgs data peristiwa ketika peristiwa postback terjadi. Saat postback HotSpot diklik, Click peristiwa akan dimunculkan. Untuk mengontrol tindakan yang dilakukan secara terprogram saat postback HotSpot diklik, berikan penanganan aktivitas untuk peristiwa tersebut Click .

Jika Anda menentukan HotSpotMode.Inactive untuk HotSpot.HotSpotMode properti , HotSpot objek tidak memiliki perilaku apa pun saat diklik. Anda dapat menggunakan nilai ini untuk membuat hot spot yang tidak aktif dalam hot spot aktif yang lebih besar. Opsi ini disediakan untuk memungkinkan Anda membuat zona hot spot yang ImageMap lebih kompleks dalam kontrol.

Untuk membuat area tidak aktif dalam hot spot aktif, Anda harus menentukan hot spot yang tidak aktif sebelum yang aktif dalam ImageMap kontrol. Misalnya, berikut ini ImageMap mendefinisikan cincin aktif dengan menentukan hot spot melingkar yang tidak aktif dalam hot spot melingkar aktif yang lebih besar:

<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>  

Berlaku untuk

Lihat juga