ImageMap.HotSpotMode Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví výchozí chování pro HotSpot objekty ovládacího prvku ImageMap při HotSpot kliknutí na objekty.

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

Hodnota vlastnosti

HotSpotMode

Jedna z hodnot výčtu HotSpotMode . Výchozí formát je NotSet.

Výjimky

ArgumentOutOfRangeException

Zadaný typ není jednou z hodnot výčtu HotSpotMode .

Příklady

Následující příklad kódu ukazuje, jak deklarativně vytvořit ovládací prvek ImageMap , který obsahuje dva RectangleHotSpot objekty. Vlastnost ImageMap.HotSpotMode je nastavená na HotSpotMode.PostBack, což způsobí, že se stránka odešle zpět na server pokaždé, když uživatel klikne na některou z oblastí aktivního bodu. Vlastnost HotSpotMode není nastavena na každý z RectangleHotSpot objektů, protože jejich chování získává z ImageMap.HotSpotMode vlastnosti. Aby tento příklad fungoval správně, musíte pro ImageUrl vlastnost zadat vlastní image a odpovídajícím způsobem aktualizovat cestu k bitové kopii, aby ji aplikace dokázala najít.

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

Poznámky

HotSpotMode Pomocí vlastnosti určete výchozí chování kliknutí na HotSpot objekty v rámci ovládacího prvkuImageMap. Tato vlastnost je nastavena pomocí jedné z hodnot výčtu HotSpotMode . V následující tabulce jsou uvedené možné hodnoty.

Položka	Popis
`Inactive`	Objekt HotSpot nemá žádné chování.
`NotSet`	Objekt HotSpot používá chování nastavené ImageMap vlastností ovládacího prvku HotSpotMode . ImageMap Pokud ovládací prvek chování nedefinuje, HotSpot všechny objekty přecházet na adresu URL.
`Navigate`	Objekty HotSpot přejděte na adresu URL.
`PostBack`	Objekty HotSpot vygenerují zpět na server.

Chování objektu HotSpot můžete určit buď ImageMap.HotSpotMode pomocí vlastnosti ImageMap ovládacího prvku, nebo HotSpot.HotSpotMode vlastnosti každého jednotlivého HotSpot objektu. Pokud jsou nastaveny obě vlastnosti, HotSpot.HotSpotMode má vlastnost zadaná u každého jednotlivého HotSpot objektu ImageMap.HotSpotMode přednost před vlastností v ovládacím ImageMap prvku.

Když nastavíte HotSpotMode vlastnost ImageMap ovládacího prvku, všimněte si, že HotSpotMode.NotSet hodnoty a HotSpotMode.Navigate mají stejné chování: oba přecházet na adresu URL. Když zadáte HotSpotMode.NotSet vlastnost HotSpot.HotSpotMode jednotlivého HotSpot objektu, určuje HotSpot jeho chování z hodnoty HotSpotMode vlastnosti ImageMap ovládacího prvku.

Pokud pro ImageMap.HotSpotMode vlastnost zadáteHotSpotMode.Navigate, stránka přejde po kliknutí na HotSpot adresu URL. Pomocí vlastnosti NavigateUrl určete adresu URL, na které chcete přejít.

Pokud pro vlastnost zadáteHotSpotMode.PostBack, stránka po kliknutí na server vygeneruje zpětné odesláníHotSpot.ImageMap.HotSpotMode PostBackValue Pomocí vlastnosti zadejte název oblasti aktivního místa. Tento název se předá v ImageMapEventArgs datech události, když dojde k události zpětného vrácení. Po kliknutí na Click postback HotSpot se vyvolá událost. Pokud chcete programově řídit akce prováděné při kliknutí na postback HotSpot , zadejte obslužnou rutinu Click události události.

Pokud pro HotSpot.HotSpotMode vlastnost zadáteHotSpotMode.Inactive, HotSpot objekt se při kliknutí nechová. Tuto hodnotu můžete použít k vytvoření neaktivního aktivního místa v rámci většího aktivního aktivního místa. Tato možnost umožňuje vytvářet složitější zóny aktivních bodů v rámci ImageMap ovládacího prvku.

Chcete-li vytvořit neaktivní oblast v rámci aktivního aktivního aktivního místa, je nutné zadat neaktivní aktivní bod před aktivní aktivní oblastí v ovládacím ImageMap prvku. Následující ImageMap příklad definuje aktivní okruh zadáním neaktivního kruhového aktivního kruhového aktivního místa:

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

Chcete-li způsobit, že všechny HotSpot objekty v ovládacím ImageMap prvku mají stejné chování, použijte HotSpotMode vlastnost ImageMap ovládacího prvku k určení chování. Pak buď nastavte HotSpotMode vlastnost u každého jednotlivého HotSpot objektu na HotSpotMode.NotSet nebo nezadávejte hodnotu vlastnosti HotSpot.HotSpotMode .

Chcete-li určit různá chování objektů HotSpot v ovládacím prvkuImageMap, nastavte vlastnost každého jednotlivého HotSpot HotSpot.HotSpotMode objektu na HotSpotMode.Navigatehodnotu , HotSpotMode.PostBacknebo HotSpotMode.Inactive.

Poznámka

ImageMap Pokud je vlastnost ovládacího prvku ImageMap.HotSpotMode nebo HotSpot.HotSpotMode vlastnost u některého z HotSpot objektů, které obsahuje, nastavena na HotSpotMode.NotSet hodnotu nebo na hodnotu nastavena není, chování je HotSpotMode.Navigateve výchozím nastavení .

Platí pro

Sdílet prostřednictvím