ImageMapEventArgs Class

 

Provides data for the Click event of an ImageMap control.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

System.Object
  System.EventArgs
    System.Web.UI.WebControls.ImageMapEventArgs

type ImageMapEventArgs = 
    class
        inherit EventArgs
    end

NameDescription
System_CAPS_pubmethodImageMapEventArgs(String)

Initializes a new instance of the ImageMapEventArgs class.

NameDescription
System_CAPS_pubpropertyPostBackValue

Gets the String assigned to the PostBackValue property of the HotSpot object that was clicked.

NameDescription
System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

The Click event is raised when a HotSpot object in an ImageMap control is clicked. 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. To control the actions programmatically that are performed when a postback HotSpot is clicked, provide an event handler for the Click event.

A PostBackValue property stores a string that is associated with the behavior of the HotSpot object when clicked. This string is passed in the ImageMapEventArgs event data when the HotSpot is clicked.

The following code example demonstrates how to create an event handler for the Click event. The ImageMap control contains two RectangleHotSpot objects. 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. The Click event is handled by the VoteMap_Clicked event handler. The VoteMap_Clicked examines the PostBackValue property, sent in the ImageMapEventArgs data, to determine which RectangleHotSpot object is associated with the event. 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.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: