ImageMap.HotSpotMode Properti

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur perilaku default untuk HotSpot objek ImageMap kontrol saat objek diklik 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

Nilai Properti

HotSpotMode

Salah HotSpotMode satu nilai enumerasi. Default adalah NotSet.

Pengecualian

ArgumentOutOfRangeException

Jenis yang ditentukan bukan salah HotSpotMode satu nilai enumerasi.

Contoh

Contoh kode berikut menunjukkan cara membuat ImageMap kontrol yang berisi dua RectangleHotSpot objek secara deklaratif. 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 setiap RectangleHotSpot 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

HotSpotMode Gunakan properti untuk menentukan perilaku HotSpot klik default objek dalam ImageMap kontrol. Properti ini diatur menggunakan salah HotSpotMode satu nilai enumerasi. Tabel berikut mencantumkan nilai yang mungkin.

Item	Deskripsi
`Inactive`	Objek HotSpot tidak memiliki perilaku apa pun.
`NotSet`	Objek HotSpot menggunakan perilaku yang diatur oleh ImageMap properti kontrol HotSpotMode . ImageMap Jika kontrol tidak menentukan perilaku, HotSpot semua objek menavigasi ke URL.
`Navigate`	Objek HotSpot menavigasi ke URL.
`PostBack`	Objek HotSpot menghasilkan postback ke server.

Anda dapat menentukan HotSpot perilaku objek menggunakan ImageMap.HotSpotMode properti ImageMap kontrol atau HotSpot.HotSpotMode properti dari setiap objek individual HotSpot . Jika kedua properti diatur, HotSpot.HotSpotMode properti yang ditentukan pada setiap objek individu HotSpot lebih diutamakan daripada ImageMap.HotSpotMode properti pada ImageMap kontrol.

Saat Anda mengatur HotSpotMode properti ImageMap kontrol, perhatikan bahwa HotSpotMode.NotSet nilai dan HotSpotMode.Navigate memiliki perilaku yang sama: keduanya menavigasi ke URL. Saat Anda menentukan HotSpotMode.NotSet untuk HotSpot.HotSpotMode properti objek individual HotSpot , yang HotSpot menentukan perilakunya dari nilai HotSpotMode properti ImageMap kontrol.

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

Jika Anda menentukan HotSpotMode.PostBack untuk ImageMap.HotSpotMode properti , halaman menghasilkan postback ke server saat HotSpot diklik. PostBackValue Gunakan properti untuk menentukan nama wilayah hot spot. 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 hot spot 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>

Untuk menyebabkan semua HotSpot objek dalam ImageMap kontrol memiliki perilaku yang sama, gunakan HotSpotMode properti pada ImageMap kontrol untuk menentukan perilaku. Kemudian, atur HotSpotMode properti pada setiap objek individual HotSpot ke HotSpotMode.NotSet atau jangan tentukan nilai untuk HotSpot.HotSpotMode properti .

Untuk menentukan perilaku yang berbeda untuk HotSpot objek dalam ImageMap kontrol, atur HotSpot.HotSpotMode properti pada setiap objek individual HotSpot ke HotSpotMode.Navigate, , HotSpotMode.PostBackatau HotSpotMode.Inactive.

Catatan

ImageMap Jika properti kontrol ImageMap.HotSpotMode atau HotSpot.HotSpotMode properti pada salah satu objek yang HotSpot dikandungnya diatur ke HotSpotMode.NotSet atau tidak diatur ke nilai, secara default perilakunya adalah HotSpotMode.Navigate.

Berlaku untuk

Bagikan melalui