HotSpotMode HotSpotMode HotSpotMode HotSpotMode Enum

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

Felder

Inactive Inactive Inactive Inactive 3

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

Navigate Navigate Navigate Navigate 1

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

NotSet NotSet NotSet 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 PostBack PostBack 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 ImageMap.HotSpotMode werden, um die-Eigenschaft festzulegen.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, RectangleHotSpot das zwei-Objekte enthält.The page contains an ImageMap control that contains two RectangleHotSpot objects. Die ImageMap.HotSpotMode -Eigenschaft ist auf HotSpotMode.PostBackfestgelegt, 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 RectangleHotSpot der-Objekte festgelegt, da Sie Ihr Verhalten von ImageMap.HotSpotMode der-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 ImageUrl -Eigenschaft ein eigenes Image bereitstellen 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 HotSpot ein-Objekt ImageMap in einem-Steuerelement anwenden können.The HotSpotMode enumeration represents the behaviors that you can apply to a HotSpot object within an ImageMap control. Die ImageMap.HotSpotMode -Eigenschaft HotSpot.HotSpotMode und die-Eigenschaft verwenden diese Enumerationswerte, um HotSpot das Verhalten eines-Objekts festzulegen, 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, HotSpot.HotSpotMode hat die für jedes einzelne HotSpot Objekt angegebene Eigenschaft Vorrang vor ImageMap.HotSpotMode 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 für HotSpotMode.NotSet die HotSpot.HotSpotMode -Eigenschaft eines einzelnen HotSpot Objekts angeben, ruft HotSpot das Verhalten aus der- ImageMap.HotSpotMode Eigenschaft ImageMap des enthaltenden Steuer Elements ab.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 HotSpotMode Eigenschaft des Steuer Elements entweder NotSet ist 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 HotSpotMode.Navigatedas Verhalten standardmäßig.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. HotSpot.HotSpotMode Wenn außerdem die Eigenschaften HotSpot der Objekte, die in einem ImageMap -Steuerelement enthalten sind, HotSpotMode.NotSet auf festgelegt sind und kein Wert ImageMap.HotSpotMode für die-Eigenschaft angegeben wird HotSpotMode.Navigate, ist das Standardverhalten.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 für HotSpotMode.Navigate die ImageMap.HotSpotMode -Eigenschaft oder die HotSpot.HotSpotMode -Eigenschaft angeben, wird die Seite zu einer URL navigiert HotSpot , wenn auf das 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 Image.NavigateUrl die- HotSpot.NavigateUrl Eigenschaft oder die-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 für HotSpotMode.PostBack die ImageMap.HotSpotMode -Eigenschaft oder die HotSpot.HotSpotMode -Eigenschaft angeben, generiert die Seite ein Postback an den Server, HotSpot wenn auf das 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 PostBackValue die-Eigenschaft, um einen Namen HotSpot für das-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, wird das Click -Ereignis ausgelöst.When a postback HotSpot is clicked, the Click event is raised. Um die Aktionen Programm gesteuert zu steuern, die beim Klicken HotSpot auf ein Postback ausgeführt werden, geben Sie Click einen Ereignishandler für das Ereignis an.To programmatically control the actions performed when a postback HotSpot is clicked, provide an event handler for the Click event.

Wenn Sie für HotSpotMode.Inactive die HotSpot.HotSpotMode -Eigenschaft angeben, HotSpot hat das-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 ImageMap -Steuer Elements erstellen können.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 ImageMap Steuerelement angeben.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 ImageMap Beispiel wird 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