ImageMap.HotSpotMode Vlastnost

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í hodnota 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ření ImageMap ovládacího prvku, který obsahuje dva RectangleHotSpot objekty. Vlastnost je nastavena ImageMap.HotSpotMode na HotSpotMode.PostBackhodnotu , která způsobí, že se stránka publikuje zpět na server pokaždé, když uživatel klikne na jednu z oblastí aktivního místa. Vlastnost není nastavena HotSpotMode pro každý z RectangleHotSpot objektů, protože z této ImageMap.HotSpotMode vlastnosti získávají své chování. 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 obrázku, 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 kliknutí na objekty v ovládacím ImageMap prvku. Tato vlastnost je nastavena pomocí jedné z hodnot výčtu HotSpotMode . Následující tabulka uvádí možné hodnoty.

Položka	Description
`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 nedefinuje chování, HotSpot všechny objekty přecházet na adresu URL.
`Navigate`	Objekty HotSpot přechádí na adresu URL.
`PostBack`	Objekty HotSpot generují postback na server.

Chování objektu můžete zadat HotSpot buď pomocí vlastnosti ImageMap ovládacího prvku, nebo HotSpot.HotSpotMode vlastnosti každého jednotlivého HotSpot objektuImageMap.HotSpotMode. Pokud jsou nastaveny obě vlastnosti, HotSpot.HotSpotMode má vlastnost zadaná u každého jednotlivého HotSpot ImageMap.HotSpotMode objektu 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 obě HotSpotMode.NavigateHotSpotMode.NotSet hodnoty mají stejné chování: oba přejděte na adresu URL. Pokud zadáte HotSpotMode.NotSet vlastnost HotSpot.HotSpotMode jednotlivého HotSpot objektu, který HotSpot určuje jeho chování z hodnoty HotSpotMode vlastnosti ImageMap ovládacího prvku.

Pokud pro vlastnost zadáte HotSpotMode.NavigateImageMap.HotSpotMode , stránka po kliknutí přejde na adresu URL HotSpot . NavigateUrl Pomocí vlastnosti zadejte adresu URL, na které chcete přejít.

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

Pokud pro vlastnost zadáte HotSpotMode.InactiveHotSpot.HotSpotMode , HotSpot objekt při kliknutí nemá žádné chování. 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 vám umožní vytvořit složitější zóny aktivních míst v rámci ImageMap ovládacího prvku.

Chcete-li vytvořit neaktivní oblast v aktivním horkém místě, musíte před aktivním horkým místem v ovládacím ImageMap prvku zadat neaktivní aktivní bod. Následující ImageMap příklad definuje aktivní okruh zadáním neaktivního kruhového horkého místa v rámci většího aktivního kruhového horké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 HotSpotMode.NotSet , nebo nezadávejte hodnotu vlastnosti HotSpot.HotSpotMode .

Chcete-li určit různé chování objektů HotSpot v ovládacím ImageMap prvku, nastavte HotSpot.HotSpotMode vlastnost u každého jednotlivého 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 u některého z HotSpot objektů, které obsahuje, nastavena nebo HotSpotMode.NotSet není nastavena na hodnotu, ve výchozím nastavení je HotSpotMode.Navigatechování .

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?