RectangleHotSpot Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit une zone réactive rectangulaire dans un contrôle ImageMap. Cette classe ne peut pas être héritée.
public ref class RectangleHotSpot sealed : System::Web::UI::WebControls::HotSpotpublic sealed class RectangleHotSpot : System.Web.UI.WebControls.HotSpottype RectangleHotSpot = class
inherit HotSpotPublic NotInheritable Class RectangleHotSpot
Inherits HotSpot- Héritage
Exemples
L’exemple de code suivant montre comment créer de manière déclarative un ImageMap contrôle qui contient deux RectangleHotSpot objets. La ImageMap.HotSpotMode propriété est définie HotSpotMode.PostBacksur , ce qui entraîne la publication de la page sur le serveur chaque fois qu’un utilisateur clique sur l’une des régions à chaud. Chaque fois que l’utilisateur clique sur l’un des RectangleHotSpot objets, la GetCoordinates méthode est appelée et les coordonnées du point chaud sélectionné sont affichées à l’utilisateur. Pour que cet exemple fonctionne correctement, vous devez fournir votre propre image pour la ImageUrl propriété et mettre à jour le chemin d’accès à l’image de manière appropriée afin que l’application puisse la localiser.
<%@ 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>
Remarques
Cette classe définit une région de point chaud rectangulaire dans un ImageMap contrôle. Pour définir la région de l’objet RectangleHotSpot , définissez la Left propriété sur la valeur qui représente la coordonnée x du coin supérieur gauche de la région rectangulaire. Définissez la Top propriété sur la valeur qui représente la coordonnée y du coin supérieur gauche de la région rectangulaire. Définissez la Right propriété sur la valeur qui représente la coordonnée x du coin inférieur droit de la région rectangulaire. Définissez la Bottom propriété sur la valeur qui représente la coordonnée y du coin inférieur droit de la région rectangulaire.
Lorsqu’un RectangleHotSpot contrôle est cliqué, la page accède à une URL, génère une publication sur le serveur ou ne fait rien. La HotSpotMode propriété spécifie ce comportement. Pour accéder à une URL, définissez la HotSpotMode propriété HotSpotMode.Navigate et utilisez la NavigateUrl propriété pour spécifier l’URL à laquelle accéder. Pour revenir au serveur, définissez la HotSpotMode propriété et utilisez la PostBackValue propriété pour spécifier un nom pour l’objet RectangleHotSpot HotSpotMode.PostBack. Ce nom est transmis dans les ImageMapEventArgs données d’événement lorsque le RectangleHotSpot clic est fait. . Si vous souhaitez que l’objet HotSpot n’ait aucun comportement, définissez la propriété HotSpotMode.Inactivesur HotSpotMode .
Constructeurs
| RectangleHotSpot() |
Initialise une nouvelle instance de la classe RectangleHotSpot. |
Propriétés
| AccessKey |
Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers la région HotSpot. (Hérité de HotSpot) |
| AlternateText |
Obtient ou définit le texte de remplacement à afficher pour un objet HotSpot d'un contrôle ImageMap lorsque l'image n'est pas disponible ou s'affiche sur un navigateur qui ne prend pas en charge les images. (Hérité de HotSpot) |
| Bottom |
Obtient ou définit la coordonnée y du côté inférieur de la zone rectangulaire définie par cet objet RectangleHotSpot. |
| HotSpotMode |
Obtient ou définit le comportement d'un objet HotSpot d'un contrôle ImageMap suite à un clic sur HotSpot. (Hérité de HotSpot) |
| IsTrackingViewState |
Obtient une valeur indiquant si l'objet HotSpot effectue le suivi des modifications de son état d'affichage. (Hérité de HotSpot) |
| Left |
Obtient ou définit la coordonnée x du côté gauche de la zone rectangulaire définie par cet objet RectangleHotSpot. |
| MarkupName |
En cas de substitution dans une classe dérivée, obtient la représentation sous forme de chaîne de la forme de l'objet HotSpot. (Hérité de HotSpot) |
| NavigateUrl |
Obtient ou définit l'URL à laquelle accéder lors d'un clic sur un objet HotSpot. (Hérité de HotSpot) |
| PostBackValue |
Obtient ou définit le nom de l'objet HotSpot à passer dans les données d'événement lors d'un clic sur HotSpot. (Hérité de HotSpot) |
| Right |
Obtient ou définit la coordonnée x du côté droit de la zone rectangulaire définie par cet objet RectangleHotSpot. |
| TabIndex |
Obtient ou définit l'index de tabulation de la région HotSpot. (Hérité de HotSpot) |
| Target |
Obtient ou définit la fenêtre ou le frame cible sur lequel afficher le contenu de la page Web vers laquelle un lien est établi lorsqu'un clic est effectué sur un objet HotSpot qui navigue vers une URL. (Hérité de HotSpot) |
| Top |
Obtient ou définit la coordonnée y du côté supérieur de la zone rectangulaire définie par cet objet RectangleHotSpot. |
| ViewState |
Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un objet HotSpot entre plusieurs demandes de la même page. (Hérité de HotSpot) |
Méthodes
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| GetCoordinates() |
Retourne une chaîne qui représente les coordonnées x et y du coin supérieur gauche d'un objet RectangleHotSpot et les coordonnées x et y de son coin inférieur droit. |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| LoadViewState(Object) |
Restaure sur l'objet l'état d'affichage précédemment enregistré de l'objet HotSpot. (Hérité de HotSpot) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| SaveViewState() |
Enregistre les modifications apportées à l'état d'affichage de l'objet HotSpot depuis la publication de la page sur le serveur. (Hérité de HotSpot) |
| ToString() |
Retourne la représentation String de cette instance d'un objet HotSpot. (Hérité de HotSpot) |
| TrackViewState() |
Amène l'objet HotSpot à suivre les modifications de son état d'affichage afin qu'elles puissent être stockées dans l'objet StateBag de l'objet. Cet objet est accessible via la propriété ViewState. (Hérité de HotSpot) |
Implémentations d’interfaces explicites
| IStateManager.IsTrackingViewState |
Obtient une valeur indiquant si l'objet HotSpot effectue le suivi des modifications de son état d'affichage. (Hérité de HotSpot) |
| IStateManager.LoadViewState(Object) |
Restaure sur l'objet l'état d'affichage précédemment enregistré de l'objet HotSpot. (Hérité de HotSpot) |
| IStateManager.SaveViewState() |
Enregistre les modifications apportées à l'état d'affichage de l'objet HotSpot depuis la dernière publication de la page sur le serveur. (Hérité de HotSpot) |
| IStateManager.TrackViewState() |
Indique à la région HotSpot de suivre les modifications apportées à son état d'affichage. (Hérité de HotSpot) |