ImageMap.HotSpotMode Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Nesneler tıklatıldığında HotSpot denetimin HotSpot ImageMap nesneleri için varsayılan davranışı alır veya ayarlar.

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

Özellik Değeri

HotSpotMode

HotSpotMode Numaralandırma değerlerinden biri. Varsayılan değer: NotSet.

Özel durumlar

ArgumentOutOfRangeException

Belirtilen tür numaralandırma değerlerinden HotSpotMode biri değil.

Örnekler

Aşağıdaki kod örneği, bildirim temelli olarak iki RectangleHotSpot nesne içeren bir ImageMap denetimin nasıl oluşturulacağını gösterir. ImageMap.HotSpotMode özelliği olarak ayarlanır HotSpotMode.PostBackve kullanıcı etkin nokta bölgelerinden birine her tıklayışında sayfanın sunucuya geri göndermesine neden olur. HotSpotMode özelliği, davranışlarını özelliğinden aldıkları için nesnelerin her RectangleHotSpot birinde ImageMap.HotSpotMode ayarlanmaz. Bu örneğin doğru çalışması için özellik için kendi görüntünüzü sağlamanız ve uygulamanın onu bulabilmesi için ImageUrl görüntünün yolunu uygun şekilde güncelleştirmeniz gerekir.

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

Açıklamalar

Bir denetim içindeki HotSpotMode ImageMap nesnelerin varsayılan tıklama davranışını HotSpot belirtmek için özelliğini kullanın. Bu özellik, numaralandırma değerlerinden HotSpotMode biri kullanılarak ayarlanır. Aşağıdaki tabloda olası değerler listelemektedir.

Öğe	Açıklama
`Inactive`	Nesnenin HotSpot herhangi bir davranışı yok.
`NotSet`	nesnesi, HotSpot denetimin ImageMap HotSpotMode özelliği tarafından ayarlanan davranışı kullanır. ImageMap Denetim davranışı tanımlamazsa, HotSpot nesnelerin tümü bir URL'ye gider.
`Navigate`	Nesneler HotSpot bir URL'ye gider.
`PostBack`	HotSpot Nesneler sunucuya bir geri gönderme oluşturur.

Bir nesnenin davranışını, denetimin özelliğini veya her HotSpot bir nesnenin HotSpot.HotSpotMode özelliğini kullanarak belirtebilirsinizHotSpot.ImageMap.HotSpotMode ImageMap Her iki özellik de ayarlanırsa, HotSpot.HotSpotMode her bir HotSpot nesnede belirtilen özellik denetimdeki özelliğinden ImageMap.HotSpotMode ImageMap önceliklidir.

Denetimin HotSpotMode özelliğini ayarladığınızda ImageMap ve HotSpotMode.Navigate değerlerinin aynı davranışa sahip olduğunu HotSpotMode.NotSet unutmayın: her ikisi de URL'ye gider. Tek bir nesnenin HotSpot.HotSpotMode özelliğini belirttiğinizdeHotSpotMode.NotSet, HotSpot bu nesnenin davranışını denetimin özelliğinin HotSpotMode değerinden ImageMap belirler.HotSpot

özelliği için ImageMap.HotSpotMode belirtirsenizHotSpotMode.Navigate, tıklandığında sayfa bir URL'ye HotSpot gider. NavigateUrl Gidilmesi gereken URL'yi belirtmek için özelliğini kullanın.

özelliği için ImageMap.HotSpotMode belirtirsenizHotSpotMode.PostBack, tıklandığında HotSpot sayfa sunucuya bir geri gönderme oluşturur. PostBackValue Etkin nokta bölgesinin adını belirtmek için özelliğini kullanın. Bu ad, bir geri gönderme olayı gerçekleştiğinde ImageMapEventArgs olay verilerinde geçirilir. Bir geri göndermeye HotSpot tıklandığında, Click olay oluşturulur. Bir geri gönderme HotSpot tıklandığında gerçekleştirilen eylemleri program aracılığıyla denetlemek için olay için bir olay işleyicisi Click sağlayın.

özelliği için HotSpot.HotSpotMode belirtirsenizHotSpotMode.Inactive, HotSpot nesne tıklandığında herhangi bir davranışa sahip değildir. Bu değeri, daha büyük bir etkin etkin nokta içinde etkin olmayan bir etkin nokta oluşturmak için kullanabilirsiniz. Bu seçenek, bir ImageMap denetim içinde daha karmaşık etkin nokta bölgeleri oluşturmanıza olanak sağlamak için sağlanır.

Etkin bir etkin nokta içinde etkin olmayan bir alan oluşturmak için, denetimdeki etkin etkin nokta öncesinde etkin olmayan etkin noktayı ImageMap belirtmeniz gerekir. Örneğin, aşağıdakiler ImageMap daha büyük bir etkin dairesel etkin nokta içinde etkin olmayan bir dairesel etkin nokta belirterek etkin bir halka tanımlar:

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

Bir ImageMap denetimdeki tüm HotSpot nesnelerin aynı davranışa sahip olmasını sağlamak için, denetimin HotSpotMode ImageMap davranışını belirtmek için özelliğini kullanın. Ardından, her bir nesnedeki HotSpotMode özelliğini olarak HotSpotMode.NotSet ayarlayın veya özellik için HotSpot.HotSpotMode bir değer belirtmeyin.HotSpot

Denetimdeki nesneler için farklı davranışlar belirtmek içinHotSpot, her HotSpot bir ImageMap nesnedeki HotSpot.HotSpotMode özelliğini , HotSpotMode.PostBackveya HotSpotMode.Inactiveolarak HotSpotMode.Navigateayarlayın.

Not

Bir ImageMap denetimin ImageMap.HotSpotMode HotSpot.HotSpotMode özelliği veya içerdiği nesnelerden herhangi birinde HotSpot özelliği bir değere HotSpotMode.NotSet ayarlanmışsa veya ayarlanmadıysa, varsayılan olarak davranış olur HotSpotMode.Navigate.

Şunlara uygulanır