ImageMap.HotSpotMode Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger standardbeteendet för objekten i HotSpot en ImageMap kontroll när objekten HotSpot klickas.

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

Egenskapsvärde

HotSpotMode

Ett av uppräkningsvärdena HotSpotMode . Standardvärdet är NotSet.

Undantag

ArgumentOutOfRangeException

Den angivna typen är inte ett av uppräkningsvärdena HotSpotMode .

Exempel

I följande kodexempel visas hur du deklarativt skapar en ImageMap kontroll som innehåller två RectangleHotSpot objekt. Egenskapen ImageMap.HotSpotMode är inställd på HotSpotMode.PostBack, vilket gör att sidan skickas tillbaka till servern varje gång en användare klickar på någon av de aktiva områdena. Egenskapen HotSpotMode är inte inställd på vart och ett av objekten RectangleHotSpot eftersom de får sitt beteende från ImageMap.HotSpotMode egenskapen. För att det här exemplet ska fungera korrekt måste du ange en egen avbildning för ImageUrl egenskapen och uppdatera sökvägen till avbildningen på lämpligt sätt så att programmet kan hitta den.

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

Kommentarer

Använd egenskapen HotSpotMode för att ange standardbeteendet för klick för objekten HotSpot i en ImageMap kontroll. Den här egenskapen anges med ett av uppräkningsvärdena HotSpotMode . I följande tabell visas möjliga värden.

Objekt Description
Inactive Objektet HotSpot har inget beteende.
NotSet Objektet HotSpot använder beteendet som anges av ImageMap kontrollens HotSpotMode egenskap. Om kontrollen ImageMap inte definierar beteendet HotSpot navigerar alla objekt till en URL.
Navigate Objekten HotSpot navigerar till en URL.
PostBack Objekten HotSpot genererar en postback till servern.

Du kan ange ett HotSpot objekts beteende med antingen ImageMap.HotSpotMode egenskapen ImageMap för kontrollen eller egenskapen för HotSpot.HotSpotMode varje enskilt HotSpot objekt. Om båda egenskaperna anges har egenskapen HotSpot.HotSpotMode som angetts för varje enskilt HotSpot objekt företräde framför ImageMap.HotSpotMode egenskapen på ImageMap kontrollen.

När du anger HotSpotMode kontrollens ImageMap egenskap bör du tänka på att HotSpotMode.NotSet värdena och HotSpotMode.Navigate har samma beteende: båda navigerar till en URL. När du anger HotSpotMode.NotSet för egenskapen HotSpot.HotSpotMode för ett enskilt HotSpot objekt avgör det HotSpot dess beteende från värdet för HotSpotMode kontrollens ImageMap egenskap.

Om du anger HotSpotMode.Navigate för egenskapen ImageMap.HotSpotMode navigerar sidan till en URL när du klickar på den HotSpot . Använd egenskapen NavigateUrl för att ange url:en som du vill navigera till.

Om du anger HotSpotMode.PostBack för ImageMap.HotSpotMode egenskapen genererar sidan ett återanrop till servern när du klickar på den HotSpot . Använd egenskapen PostBackValue för att ange namnet på hot spot-regionen. Det här namnet skickas i ImageMapEventArgs händelsedata när en postback-händelse inträffar. När du klickar på en postback HotSpot aktiveras händelsen Click . Ange en händelsehanterare för händelsen för HotSpot att programmatiskt kontrollera de åtgärder som utförs när du klickar på en postbackClick.

Om du anger HotSpotMode.Inactive för egenskapen HotSpot.HotSpotModeHotSpot har objektet inget beteende när det klickas. Du kan använda det här värdet för att skapa en inaktiv frekvent plats i en större aktiv aktiv frekvent plats. Det här alternativet tillhandahålls så att du kan skapa mer komplexa hot spot-zoner i en ImageMap kontroll.

Om du vill skapa ett inaktivt område inom en aktiv frekvent plats måste du ange den inaktiva frekventa platsen före den aktiva frekventa platsen i ImageMap kontrollen. Följande definierar till exempel ImageMap en aktiv ring genom att ange en inaktiv cirkulär frekvent punkt i en större aktiv cirkulär frekvent punkt:

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

Om du vill att alla HotSpot objekt i en ImageMap kontroll ska ha samma beteende använder du HotSpotMode egenskapen på ImageMap kontrollen för att ange beteendet. Ange sedan HotSpotMode egenskapen för varje enskilt HotSpot objekt till HotSpotMode.NotSet eller ange inget värde för egenskapen HotSpot.HotSpotMode .

Om du vill ange olika beteenden för HotSpot objekt i en ImageMap kontroll anger du HotSpot.HotSpotMode egenskapen för varje enskilt HotSpot objekt till antingen HotSpotMode.Navigate, HotSpotMode.PostBackeller HotSpotMode.Inactive.

Note

Om en ImageMap kontrolls ImageMap.HotSpotMode egenskap eller HotSpot.HotSpotMode egenskapen på något av de objekt som den HotSpot innehåller är antingen inställd HotSpotMode.NotSet på eller inte inställt på ett värde är HotSpotMode.Navigatebeteendet som standard .

Gäller för

Se även