ImageMapEventArgs ImageMapEventArgs ImageMapEventArgs ImageMapEventArgs Class

Definition

Stellt Daten für das Click-Ereignis eines ImageMap-Steuerelements bereit.Provides data for the Click event of an ImageMap control.

public ref class ImageMapEventArgs : EventArgs
public class ImageMapEventArgs : EventArgs
type ImageMapEventArgs = class
    inherit EventArgs
Public Class ImageMapEventArgs
Inherits EventArgs
Vererbung
ImageMapEventArgsImageMapEventArgsImageMapEventArgsImageMapEventArgs

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Ereignishandler für das Click -Ereignis erstellt wird.The following code example demonstrates how to create an event handler for the Click event. Das ImageMap -Steuerelement RectangleHotSpot enthält zwei-Objekte.The ImageMap control contains two RectangleHotSpot objects. Die ImageMap.HotSpotMode -Eigenschaft ist auf HotSpotMode.PostBackfestgelegt, sodass die Seite jedes Mal, wenn ein RectangleHotSpot Benutzer auf eines der Objekte 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 RectangleHotSpot objects. Das Click Ereignis wird VoteMap_Clicked vom Ereignishandler behandelt.The Click event is handled by the VoteMap_Clicked event handler. Der VoteMap_Clicked überprüft die PostBackValue -Eigenschaft, die in ImageMapEventArgs den Daten gesendet wird, RectangleHotSpot um zu bestimmen, welches Objekt dem Ereignis zugeordnet ist.The VoteMap_Clicked examines the PostBackValue property, sent in the ImageMapEventArgs data, to determine which RectangleHotSpot object is associated with the event. 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)
  {
    string coordinates;
    string hotSpotType;
    int yescount = ((ViewState["yescount"] != null)? (int)ViewState["yescount"] : 0);
    int nocount = ((ViewState["nocount"] != null)? (int)ViewState["nocount"] : 0);

    // When a user clicks the "Yes" hot spot,
    // display the hot spot's name and coordinates.
    if (e.PostBackValue.Contains("Yes"))
    {
      yescount += 1;
      coordinates = Vote.HotSpots[0].GetCoordinates();
      hotSpotType = Vote.HotSpots[0].ToString ();
      Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue + ".<br />" +
                      "The coordinates are " + coordinates + ".<br />" +
                      "The current vote count is " + yescount.ToString() + 
            " yes votes and " + nocount.ToString() + " no votes.";
    }
      
    // When a user clicks the "No" hot spot,
    // display the hot spot's name and coordinates.
    else if (e.PostBackValue.Contains("No"))
    {
      nocount += 1;
      coordinates = Vote.HotSpots[1].GetCoordinates();
      hotSpotType = Vote.HotSpots[1].ToString ();
      Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue + ".<br />" +
                      "The coordinates are " + coordinates + ".<br />" +
            "The current vote count is " + yescount.ToString() +
            " yes votes and " + nocount.ToString() + " no votes.";
    }
    
    else
    {
      Message1.Text = "You did not click a valid hot spot region.";
    }

    ViewState["yescount"] = yescount;
    ViewState["nocount"] = nocount;
  }           
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageMap Class Post Back Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>ImageMap Class Post Back Example</h3>
      
      <asp:imagemap id="Vote"           
        imageurl="Images/VoteImage.jpg"
        width="400" 
        height="200" 
        alternatetext="Vote Yes or No"
        hotspotmode="PostBack"
        onclick="VoteMap_Clicked"
        runat="Server">            
          
        <asp:RectangleHotSpot          
          top="0"
          left="0"
          bottom="200"
          right="200"
          postbackvalue="Yes"
          alternatetext="Vote yes">
        </asp:RectangleHotSpot>
          
        <asp:RectangleHotSpot 
          top="0"
          left="201"
          bottom="200"
          right="400"
          postbackvalue="No"
          alternatetext="Vote no">
        </asp:RectangleHotSpot>
      
      </asp:imagemap>
            
      <br /><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)
    Dim coordinates As String
    Dim hotSpotType As String
    Dim yescount As Integer
    Dim nocount As Integer
    
    If (ViewState("yescount") IsNot Nothing) Then
      yescount = Convert.ToInt32(ViewState("yescount"))
    Else
      yescount = 0
    End If
    If (ViewState("nocount") IsNot Nothing) Then
      nocount = Convert.ToInt32(ViewState("nocount"))
    Else
      nocount = 0
    End If
      
    
    ' When a user clicks the "Yes" hot spot,
    ' display the hot spot's name and coordinates.
    If (e.PostBackValue.Contains("Yes")) Then
      
      yescount += 1
      coordinates = Vote.HotSpots(0).GetCoordinates()
      hotSpotType = Vote.HotSpots(0).ToString()
      Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue & ".<br />" & _
                      "The coordinates are " & coordinates & ".<br />" & _
                      "The current vote count is " & yescount.ToString() & _
                      " yes votes and " & nocount.ToString() & " no votes."
       
      ' When a user clicks the "No" hot spot,
      ' display the hot spot's name and coordinates.
    ElseIf (e.PostBackValue.Contains("No")) Then
      
      nocount += 1
      coordinates = Vote.HotSpots.Item(1).GetCoordinates()
      hotSpotType = Vote.HotSpots.Item(1).ToString()
      Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue & ".<br />" & _
                     "The coordinates are " & coordinates & ".<br />" & _
                      "The current vote count is " & yescount.ToString() & _
                      " yes votes and " & nocount.ToString() & " no votes."
      
    Else
      
      Message1.Text = "You did not click a valid hot spot region."
                
    End If
      
    ViewState("yescount") = yescount
    ViewState("nocount") = nocount
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageMap Class Post Back Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>ImageMap Class Post Back Example</h3>
      
      <asp:imagemap id="Vote"           
        imageurl="Images/VoteImage.jpg"
        width="400" 
        height="200" 
        alternatetext="Vote Yes or No"
        hotspotmode="PostBack"
        onclick="VoteMap_Clicked"
        runat="Server">            
          
        <asp:RectangleHotSpot          
          top="0"
          left="0"
          bottom="200"
          right="200"
          postbackvalue="Yes"
          alternatetext="Vote yes">
        </asp:RectangleHotSpot>
          
        <asp:RectangleHotSpot 
          top="0"
          left="201"
          bottom="200"
          right="400"
          postbackvalue="No"
          alternatetext="Vote no">
        </asp:RectangleHotSpot>
      
      </asp:imagemap>
            
      <br /><br />
          
      <asp:label id="Message1"
        runat="Server">
      </asp:label>                 
                 
    </form>      
  </body>
</html>

Hinweise

Das Click -Ereignis wird ausgelöst, HotSpot wenn auf ein ImageMap -Objekt in einem-Steuerelement geklickt wird.The Click event is raised when a HotSpot object in an ImageMap control is clicked. Damit HotSpot ein-Objekt das ImageMap.HotSpotMode Click -Ereignis erhöhen kann, müssen Sie entweder die-Eigenschaft oder die HotSpot.HotSpotMode -Eigenschaft HotSpotMode.PostBackauf festlegen.To allow a HotSpot object to raise the Click event, you must first set either the ImageMap.HotSpotMode property or the HotSpot.HotSpotMode property to HotSpotMode.PostBack. Um die Aktionen Programm gesteuert zu steuern, die beim Klicken auf ein HotSpot Postback ausgeführt werden, geben Sie einen Ereignis Click Handler für das Ereignis an.To control the actions programmatically that are performed when a postback HotSpot is clicked, provide an event handler for the Click event.

Eine PostBackValue Eigenschaft speichert eine Zeichenfolge, die dem Verhalten HotSpot des Objekts zugeordnet ist, wenn darauf geklickt wird.A PostBackValue property stores a string that is associated with the behavior of the HotSpot object when clicked. Diese Zeichenfolge wird in den ImageMapEventArgs Ereignisdaten beim Klicken HotSpot auf das-Ereignis übermittelt.This string is passed in the ImageMapEventArgs event data when the HotSpot is clicked.

Konstruktoren

ImageMapEventArgs(String) ImageMapEventArgs(String) ImageMapEventArgs(String) ImageMapEventArgs(String)

Initialisiert eine neue Instanz der ImageMapEventArgs-Klasse.Initializes a new instance of the ImageMapEventArgs class.

Eigenschaften

PostBackValue PostBackValue PostBackValue PostBackValue

Ruft das String-Objekt ab, das der PostBackValue-Eigenschaft des HotSpot-Objekts zugewiesen ist, auf das geklickt wurde.Gets the String assigned to the PostBackValue property of the HotSpot object that was clicked.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch