| aspxtreme |
Home Getting Started Web Forms Web Applications ADO.NET ASP/ADO Back to Basics |
  |
ImageMap.Target Property
System.Web.UI.WebControls Namespace ImageMap Class
Sets or retrieves the target window or frame that displays the content when the ImageMap control is clicked.
Syntax
| Inline | <asp:imagemap target = strTarget | '_blank' | '_parent' | '_self' | '_top' ... > |
|---|---|
| Script | ImageMap.Target [ = strTarget | '_blank' | '_parent' | '_self' | '_top' ] |
Property Value
| strTarget | The name of the target window or frame to load the Web page content into. |
Values must begin with a letter in the range of A-Z or a-z, except for these special values which begin with an underscore:
| _blank | Renders the content in a new, unframed window. |
| _parent | Renders the content in the immediate frameset parent. |
| _self | Renders the content in the current frame. |
| _top | Renders the content in the full, unframed window. |
The property is read/write with a default value that depends on the URL and site. If the user does not leave the site, the default is _self, but if the user exits to a new site, the default is _top.
Remarks
Use this property to specify the frame or window in which to display the contents of the requested resource.
The Target property is used when the value of the HotSpotMode property is HotSpotMode.Navigate; it is ignored when the value of the HotSpotMode property is HotSpotMode.PostBack.
If the Target property is not set, the browser or window with focus refreshes when the ImageMap control is clicked.
If there is no frame or window that matches the specified target, a new window is opened for the link.
CAUTION: In HTML 4.0, Target attribute values are case-insensitive, so that _top and _TOP have the same meaning. However, most browsers treat this value as case-sensitive and do not recognize _TOP as having the special meaning as described for _top.
Example
The below snippet shows how to declaratively set the Target property of an ImageMap control at design time.
<asp:imagemap id = "solarsys" runat = "server" imageurl = "~/abkd/shared/images/solarsys.gif" width=504 height=126 alternatetext = "Solar System" target = "_blank" />
