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 ImageMap ovládacího prvku při kliknutí na HotSpot 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.PostBackhodnotu , což způsobí, že stránka se odešle zpět na server pokaždé, když uživatel klikne na jednu z oblastí aktivního bodu. Vlastnost HotSpotMode není nastavena u každého objektu RectangleHotSpot , protože z vlastnosti získávají své chování ImageMap.HotSpotMode . 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 imagi, 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í HotSpot objektů v rámci ImageMap ovládacího prvku kliknutím. Tato vlastnost je nastavena pomocí jedné z hodnot výčtu HotSpotMode . Následující tabulka uvádí 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řecházet na adresu URL.
`PostBack`	Objekty HotSpot vygenerují zpětné odeslání 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í ImageMap ovládacího 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ádí na adresu URL. Když zadáte HotSpotMode.NotSet pro HotSpot.HotSpotMode vlastnost jednotlivého HotSpot objektu, určuje to 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. NavigateUrl Pomocí vlastnosti zadejte adresu URL, na které chcete přejít.

Pokud pro ImageMap.HotSpotMode vlastnost zadáteHotSpotMode.PostBack, stránka při kliknutí na server vygeneruje zpětné HotSpot odeslání. 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 odeslání. Při kliknutí na Click zpětné HotSpot odeslání se vyvolá událost. Pokud chcete programově řídit akce prováděné po kliknutí na zpětné HotSpot odeslání, zadejte obslužnou rutinu události pro událost Click .

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 místa, je nutné zadat neaktivní aktivní bod před aktivním aktivním bodem v ovládacím ImageMap prvku. Například následující ImageMap kód definuje aktivní okruh zadáním neaktivní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 budou mít stejné chování, zadejte chování pomocí HotSpotMode vlastnosti ImageMap ovládacího prvku. Pak buď nastavte HotSpotMode vlastnost pro každý jednotlivý HotSpot objekt na HotSpotMode.NotSet hodnotu, nebo nezadávejte hodnotu vlastnosti HotSpot.HotSpotMode .

Pokud chcete pro objekty HotSpot v ovládacím ImageMap prvku určit jiné chování, nastavte vlastnost každého jednotlivého HotSpot.HotSpotMode HotSpot objektu na HotSpotMode.Navigate, HotSpotMode.PostBacknebo HotSpotMode.Inactive.

Poznámka

ImageMap Pokud je vlastnost ovládacího prvku ImageMap.HotSpotMode nebo HotSpot.HotSpotMode vlastnost 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