Partager via


RectangleHotSpot Classe

Définition

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::HotSpot
public sealed class RectangleHotSpot : System.Web.UI.WebControls.HotSpot
type RectangleHotSpot = class
    inherit HotSpot
Public NotInheritable Class RectangleHotSpot
Inherits HotSpot
Héritage
RectangleHotSpot

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 sur HotSpotMode.PostBack, ce qui entraîne la publication de la page sur le serveur chaque fois qu’un utilisateur clique sur l’une des régions de point 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 propriété sur Bottom 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é sur HotSpotMode.Navigate et utilisez la NavigateUrl propriété pour spécifier l’URL à laquelle accéder. Pour effectuer une publication sur le serveur, définissez la HotSpotMode propriété sur HotSpotMode.PostBack et utilisez la PostBackValue propriété pour spécifier un nom pour l’objet RectangleHotSpot . Ce nom est passé dans les données d’événement ImageMapEventArgs lorsque l’utilisateur RectangleHotSpot clique sur . . Si vous souhaitez que l’objet HotSpot n’ait aucun comportement, définissez la propriété sur HotSpotModeHotSpotMode.Inactive.

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)

S’applique à

Voir aussi