HotSpotMode Enumeration

Definition

Gibt an, wie sich ein HotSpot-Objekt in einem ImageMap-Steuerelement verhält, wenn auf HotSpot geklickt wird.Specifies the behaviors of a HotSpot object in an ImageMap control when the HotSpot is clicked.

public enum class HotSpotMode
public enum HotSpotMode
type HotSpotMode = 
Public Enum HotSpotMode
Vererbung
HotSpotMode

Felder

Inactive 3

Der HotSpot verfügt über kein Verhalten.The HotSpot does not have any behavior.

Navigate 1

HotSpot navigiert zu einer URL.The HotSpot navigates to a URL.

NotSet 0

HotSpot verwendet das Verhalten, das durch die ImageMap-Eigenschaft des HotSpotMode-Steuerelements festgelegt wurde.The HotSpot uses the behavior set by the ImageMap control's HotSpotMode property. Wenn das Verhalten nicht durch das ImageMap-Steuerelement festgelegt wird, navigiert das HotSpot-Objekt zu einer URL.If the ImageMap control does not define the behavior, the HotSpot object navigates to a URL.

PostBack 2

HotSpot generiert ein Postback an den Server.The HotSpot generates a postback to the server.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die- HotSpotMode Enumerationswerte verwendet werden, um die-Eigenschaft festzulegen ImageMap.HotSpotMode .The following code example demonstrates how to use the HotSpotMode enumeration values to set the ImageMap.HotSpotMode property. Die Seite enthält ein- ImageMap Steuerelement, das zwei- RectangleHotSpot Objekte enthält.The page contains an ImageMap control that contains two RectangleHotSpot objects. Die- ImageMap.HotSpotMode Eigenschaft ist auf festgelegt HotSpotMode.PostBack , sodass die Seite jedes Mal, wenn ein Benutzer auf eine der Hotspot Bereiche klickt, an den Server zurückgesendet wird.The ImageMap.HotSpotMode property is set to HotSpotMode.PostBack, which causes the page to post back to the server each time a user clicks one of the hot spot regions. Die- HotSpotMode Eigenschaft wird für keines der-Objekte festgelegt, RectangleHotSpot da Sie Ihr Verhalten von der- ImageMap.HotSpotMode Eigenschaft erhalten.The HotSpotMode property is not set on either of the RectangleHotSpot objects because they get their behavior from the ImageMap.HotSpotMode property. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie für die-Eigenschaft ein eigenes Image bereitstellen ImageUrl und den Pfad zum Bild entsprechend aktualisieren, damit die Anwendung es finden kann.For this example to work correctly, you must supply your own image for the ImageUrl property and update the path to the image appropriately so that the application can locate it.

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

Die- HotSpotMode Enumeration stellt das Verhalten dar, das Sie auf ein- HotSpot Objekt in einem-Steuerelement anwenden können ImageMap .The HotSpotMode enumeration represents the behaviors that you can apply to a HotSpot object within an ImageMap control. Die ImageMap.HotSpotMode -Eigenschaft und die-Eigenschaft HotSpot.HotSpotMode verwenden diese Enumerationswerte, um das Verhalten eines-Objekts festzulegen, HotSpot Wenn darauf geklickt wird.The ImageMap.HotSpotMode and the HotSpot.HotSpotMode properties use these enumeration values to set the behavior of a HotSpot object when it is clicked. Wenn beide Eigenschaften festgelegt sind, hat die HotSpot.HotSpotMode für jedes einzelne HotSpot Objekt angegebene Eigenschaft Vorrang ImageMap.HotSpotMode vor der Eigenschaft des Steuer Elements.If both properties are set, the HotSpot.HotSpotMode property specified on each individual HotSpot object takes precedence over the ImageMap.HotSpotMode property on the control.

Wenn Sie HotSpotMode.NotSet für die HotSpot.HotSpotMode -Eigenschaft eines einzelnen HotSpot Objekts angeben, ruft das HotSpot Verhalten aus der-Eigenschaft des enthaltenden Steuer Elements ab ImageMap ImageMap.HotSpotMode .If you specify HotSpotMode.NotSet for the HotSpot.HotSpotMode property of an individual HotSpot object, the HotSpot gets its behavior from the containing ImageMap control's ImageMap.HotSpotMode property. Wenn in diesem Fall die ImageMap -Eigenschaft des Steuer Elements HotSpotMode entweder ist NotSet oder kein Wert angegeben wird, ist das Standardverhalten, zu einer URL zu navigieren.In this scenario, if the ImageMap control's HotSpotMode property is either NotSet or no value is specified, the default behavior is to navigate to a URL.

Hinweis

Wenn das ImageMap Verhalten eines Steuer Elements nicht mithilfe der- ImageMap.HotSpotMode Eigenschaft oder der- HotSpot.HotSpotMode Eigenschaft für die HotSpot darin enthaltenen-Objekte angegeben wird, ist das Verhalten standardmäßig HotSpotMode.Navigate .If an ImageMap control's behavior is not specified using either the ImageMap.HotSpotMode property or the HotSpot.HotSpotMode property on the HotSpot objects it contains, by default the behavior is HotSpotMode.Navigate. Wenn außerdem die Eigenschaften der HotSpot.HotSpotMode Objekte, die HotSpot ImageMap in einem-Steuerelement enthalten sind, auf festgelegt sind HotSpotMode.NotSet und kein Wert für die-Eigenschaft angegeben wird ImageMap.HotSpotMode , ist das Standardverhalten HotSpotMode.Navigate .In addition, if the HotSpot.HotSpotMode properties on the HotSpot objects that an ImageMap control contains are set to HotSpotMode.NotSet and no value is specified for the ImageMap.HotSpotMode property, the default behavior is HotSpotMode.Navigate.

Wenn Sie HotSpotMode.Navigate für die- ImageMap.HotSpotMode Eigenschaft oder die- HotSpot.HotSpotMode Eigenschaft angeben, wird die Seite zu einer URL navigiert, wenn auf das HotSpot geklickt wird.If you specify HotSpotMode.Navigate for either the ImageMap.HotSpotMode property or the HotSpot.HotSpotMode property, the page navigates to a URL when the HotSpot is clicked. Verwenden Sie die- Image.NavigateUrl Eigenschaft oder die- HotSpot.NavigateUrl Eigenschaft, um die URL für die Navigation anzugeben.Use the Image.NavigateUrl or the HotSpot.NavigateUrl property to specify the URL to navigate to.

Wenn Sie HotSpotMode.PostBack für die- ImageMap.HotSpotMode Eigenschaft oder die- HotSpot.HotSpotMode Eigenschaft angeben, generiert die Seite ein Postback an den Server, wenn auf das HotSpot geklickt wird.If you specify HotSpotMode.PostBack for either the ImageMap.HotSpotMode property or the HotSpot.HotSpotMode property, the page generates a postback to the server when the HotSpot is clicked. Verwenden Sie die- PostBackValue Eigenschaft, um einen Namen für das- HotSpot Objekt anzugeben.Use the PostBackValue property to specify a name for the HotSpot object. Dieser Name wird in den ImageMapEventArgs Ereignisdaten beim Auftreten des Post Back Ereignisses ausgegeben.This name will be passed in the ImageMapEventArgs event data when the postback event occurs. Wenn auf ein Postback HotSpot geklickt wird, Click wird das-Ereignis ausgelöst.When a postback HotSpot is clicked, the Click event is raised. Um die Aktionen Programm gesteuert zu steuern, die beim Klicken auf ein Postback ausgeführt HotSpot werden, geben Sie einen Ereignishandler für das Click Ereignis an.To programmatically control the actions performed when a postback HotSpot is clicked, provide an event handler for the Click event.

Wenn Sie HotSpotMode.Inactive für die- HotSpot.HotSpotMode Eigenschaft angeben, hat das- HotSpot Objekt kein Verhalten, wenn darauf geklickt wird.If you specify HotSpotMode.Inactive for the HotSpot.HotSpotMode property, the HotSpot object does not have any behavior when it is clicked. Sie können diesen Wert verwenden, um einen inaktiven Hotspot innerhalb eines größeren aktiven Hotspots zu erstellen.You can use this value to create an inactive hot spot within a larger active hot spot. Diese Option wird bereitgestellt, damit Sie komplexere Hotspot Zonen innerhalb eines-Steuer Elements erstellen können ImageMap .This option is provided to allow you to create more complex hot spot zones within an ImageMap control.

Um einen inaktiven Bereich innerhalb eines aktiven Hotspots zu erstellen, müssen Sie den inaktiven Hotspot vor dem aktiven Hotspot im Steuerelement angeben ImageMap .To create an inactive area within an active hot spot, you must specify the inactive hot spot before the active one in the ImageMap control. Im folgenden Beispiel wird ImageMap ein aktiver Ring durch Angeben eines inaktiven, Zirkel enden Hotspots in einem größeren aktiven Zirkel Hotspot definiert:For example, the following ImageMap defines an active ring by specifying an inactive circular hot spot within a larger active circular hot spot:

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

Gilt für:

Siehe auch