ImageMap.HotSpotMode Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft das Standardverhalten der HotSpot-Objekte eines ImageMap-Steuerelements ab, wenn auf die betreffenden HotSpot-Objekte geklickt wird, oder legt dieses fest.

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

Eigenschaftswert

HotSpotMode

Einer der HotSpotMode-Enumerationswerte. Der Standardwert ist NotSet.

Ausnahmen

ArgumentOutOfRangeException

Der angegebene Typ ist kein HotSpotMode-Enumerationswert.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein ImageMap Steuerelement deklarativ erstellt wird, das zwei RectangleHotSpot -Objekte enthält. Die ImageMap.HotSpotMode -Eigenschaft ist auf HotSpotMode.PostBackfestgelegt, wodurch die Seite jedes Mal, wenn ein Benutzer auf eine der Hot Spot-Regionen klickt, auf den Server zurückgibt. Die HotSpotMode -Eigenschaft ist nicht für jedes der RectangleHotSpot -Objekte festgelegt, da sie ihr Verhalten von der ImageMap.HotSpotMode -Eigenschaft abrufen. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie Ihr eigenes Image für die ImageUrl Eigenschaft angeben und den Pfad zum Bild entsprechend aktualisieren, damit die Anwendung es finden kann.

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

Hinweise

Verwenden Sie die HotSpotMode -Eigenschaft, um das Standardklickverhalten der HotSpot Objekte in einem ImageMap Steuerelement anzugeben. Diese Eigenschaft wird mithilfe eines der HotSpotMode Enumerationswerte festgelegt. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Element	Beschreibung
`Inactive`	Das HotSpot -Objekt hat kein Verhalten.
`NotSet`	Das HotSpot -Objekt verwendet das durch die -Eigenschaft des ImageMap Steuerelements HotSpotMode festgelegte Verhalten. Wenn das ImageMap -Steuerelement das Verhalten nicht definiert, navigieren alle HotSpot Objekte zu einer URL.
`Navigate`	Die HotSpot Objekte navigieren zu einer URL.
`PostBack`	Die HotSpot -Objekte generieren ein Postback auf den Server.

Sie können das Verhalten eines HotSpot Objekts angeben, indem Sie entweder die ImageMap.HotSpotMode -Eigenschaft des ImageMap -Steuerelements oder die HotSpot.HotSpotMode -Eigenschaft jedes einzelnen HotSpot Objekts verwenden. Wenn beide Eigenschaften festgelegt sind, hat die HotSpot.HotSpotMode für jedes einzelne HotSpot Objekt angegebene Eigenschaft Vorrang vor der ImageMap.HotSpotMode -Eigenschaft des -Steuerelements ImageMap .

Wenn Sie die HotSpotMode -Eigenschaft des ImageMap Steuerelements festlegen, beachten Sie, dass die HotSpotMode.NotSet Werte und HotSpotMode.Navigate das gleiche Verhalten aufweisen: Beide navigieren zu einer URL. Wenn Sie für die HotSpot.HotSpotMode -Eigenschaft eines einzelnen HotSpot Objekts angebenHotSpotMode.NotSet, bestimmt dies HotSpot dessen Verhalten anhand des Werts der HotSpotMode -Eigenschaft des ImageMap Steuerelements.

Wenn Sie für die ImageMap.HotSpotMode -Eigenschaft angebenHotSpotMode.Navigate, navigiert die Seite zu einer URL, wenn auf die HotSpot geklickt wird. Verwenden Sie die NavigateUrl -Eigenschaft, um die URL anzugeben, zu der navigiert werden soll.

Wenn Sie für die ImageMap.HotSpotMode -Eigenschaft angebenHotSpotMode.PostBack, generiert die Seite ein Postback auf den Server, wenn auf geklickt HotSpot wird. Verwenden Sie die PostBackValue -Eigenschaft, um den Namen der Hotspotregion anzugeben. Dieser Name wird in den ImageMapEventArgs Ereignisdaten übergeben, wenn ein Postbackereignis auftritt. Wenn auf ein Postback HotSpot geklickt wird, wird das Click Ereignis ausgelöst. Stellen Sie einen Ereignishandler für das Ereignis bereit, um die Aktionen programmgesteuert zu steuern, die Click beim Klicken auf ein Postback HotSpot ausgeführt werden.

Wenn Sie für die HotSpot.HotSpotMode -Eigenschaft angebenHotSpotMode.Inactive, weist das HotSpot Objekt kein Verhalten auf, wenn darauf geklickt wird. Sie können diesen Wert verwenden, um einen inaktiven Hotspot innerhalb eines größeren aktiven Hotspots zu erstellen. Diese Option wird bereitgestellt, damit Sie komplexere Hotspotzonen innerhalb eines Steuerelements ImageMap erstellen können.

Um einen inaktiven Bereich innerhalb eines aktiven Hotspots zu erstellen, müssen Sie den inaktiven Hotspot vor dem aktiven Hotspot im ImageMap Steuerelement angeben. Im Folgenden ImageMap wird beispielsweise ein aktiver Ring definiert, indem ein inaktiver kreisförmiger Hotspot innerhalb eines größeren aktiven kreisförmigen Hotspots angegeben wird:

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

Um zu bewirken, dass alle HotSpot Objekte in einem ImageMap Steuerelement das gleiche Verhalten aufweisen, verwenden Sie die HotSpotMode -Eigenschaft des ImageMap Steuerelements, um das Verhalten anzugeben. Legen Sie dann entweder die HotSpotMode -Eigenschaft für jedes einzelne HotSpot Objekt auf fest HotSpotMode.NotSet , oder geben Sie keinen Wert für die HotSpot.HotSpotMode Eigenschaft an.

Um unterschiedliche Verhaltensweisen für HotSpot Objekte in einem ImageMap Steuerelement anzugeben, legen Sie die HotSpot.HotSpotMode -Eigenschaft für jedes einzelne HotSpot Objekt entweder HotSpotMode.Navigateauf , HotSpotMode.PostBackoder HotSpotMode.Inactivefest.

Hinweis

Wenn die -Eigenschaft eines ImageMap Steuerelements ImageMap.HotSpotMode oder die HotSpot.HotSpotMode -Eigenschaft eines der HotSpot enthaltenen Objekte entweder auf HotSpotMode.NotSet einen Wert festgelegt oder nicht auf einen Wert festgelegt ist, lautet HotSpotMode.Navigatedas Verhalten standardmäßig .

Gilt für: