HotSpotMode Enumeration

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Gibt an, wie sich ein HotSpot-Objekt in einem ImageMap-Steuerelement verhält, wenn auf HotSpot geklickt wird.

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

Felder

Inactive 3

Der HotSpot verfügt über kein Verhalten.
Navigate 1

HotSpot navigiert zu einer URL.
NotSet 0

HotSpot verwendet das Verhalten, das durch die ImageMap-Eigenschaft des HotSpotMode-Steuerelements festgelegt wurde. Wenn das Verhalten nicht durch das ImageMap-Steuerelement festgelegt wird, navigiert das HotSpot-Objekt zu einer URL.
PostBack 2

HotSpot generiert ein Postback an den Server.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die HotSpotMode -Enumerationswerte zum Festlegen der ImageMap.HotSpotMode -Eigenschaft verwendet werden. Die Seite enthält ein ImageMap Steuerelement, 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 für keines 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

Die HotSpotMode -Enumeration stellt das Verhalten dar, das Sie auf ein HotSpot Objekt innerhalb eines Steuerelements ImageMap anwenden können. Die ImageMap.HotSpotMode Eigenschaften und HotSpot.HotSpotMode verwenden diese Enumerationswerte, um das Verhalten eines HotSpot Objekts festzulegen, wenn darauf geklickt wird. 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.

Wenn Sie für die HotSpot.HotSpotMode -Eigenschaft eines einzelnen HotSpot Objekts angebenHotSpotMode.NotSet, ruft dessen HotSpot Verhalten von der -Eigenschaft des enthaltenden ImageMap Steuerelements ImageMap.HotSpotMode ab. Wenn in diesem Szenario die ImageMap Eigenschaft des Steuerelements HotSpotMode ist NotSet oder kein Wert angegeben wird, besteht das Standardverhalten darin, zu einer URL zu navigieren.

Hinweis

Wenn das Verhalten eines ImageMap Steuerelements nicht mithilfe der ImageMap.HotSpotMode -Eigenschaft oder der HotSpot.HotSpotMode -Eigenschaft für die HotSpot darin enthaltenen Objekte angegeben wird, lautet HotSpotMode.Navigatedas Verhalten standardmäßig . Wenn die Eigenschaften für die HotSpot.HotSpotModeHotSpot Objekte, die ein ImageMap Steuerelement enthält, auf HotSpotMode.NotSet festgelegt sind und kein Wert für die ImageMap.HotSpotMode -Eigenschaft angegeben wird, ist HotSpotMode.Navigatedas Standardverhalten .

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

Wenn Sie entweder für die ImageMap.HotSpotMode -Eigenschaft oder die HotSpot.HotSpotMode -Eigenschaft angebenHotSpotMode.PostBack, generiert die Seite ein Postback auf den Server, wenn auf geklickt HotSpot wird. Verwenden Sie die PostBackValue -Eigenschaft, um einen Namen für das HotSpot -Objekt anzugeben. Dieser Name wird in den ImageMapEventArgs Ereignisdaten übergeben, wenn das 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 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>

Gilt für:

Weitere Informationen