RectangleHotSpot Classe

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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 région de point chaud rectangulaire dans un ImageMap contrôle. 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: Object

HotSpot
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 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 propriété sur la Top valeur qui représente la coordonnée y du coin supérieur gauche de la région rectangulaire. Définissez la propriété sur la Right valeur qui représente la coordonnée x du coin inférieur droit de la région rectangulaire. Définissez la propriété sur la Bottom 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 un billet 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é HotSpotMode.PostBack sur et utilisez la PostBackValue propriété pour spécifier un nom pour l’objet RectangleHotSpot . Ce nom est transmis dans les ImageMapEventArgs données d’événement lorsque l’utilisateur RectangleHotSpot clique dessus. . Si vous souhaitez que l’objet HotSpot n’ait aucun comportement, définissez la HotSpotMode propriété HotSpotMode.Inactivesur .

Constructeurs

Nom	Description
RectangleHotSpot()	Initialise une nouvelle instance de la classe RectangleHotSpot.

Propriétés

Nom	Description
AccessKey	Obtient ou définit la clé d’accès qui vous permet d’accéder rapidement à la HotSpot région. (Hérité de HotSpot)
AlternateText	Obtient ou définit le texte de remplacement à afficher pour un objet dans un HotSpot ImageMap contrôle lorsque l’image n’est pas disponible ou s’affiche dans 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 région rectangulaire définie par cet RectangleHotSpot objet.
HotSpotMode	Obtient ou définit le comportement d’un HotSpot objet dans un ImageMap contrôle lorsque l’utilisateur HotSpot clique dessus. (Hérité de HotSpot)
IsTrackingViewState	Obtient une valeur indiquant si l’objet HotSpot suit ses modifications d’état d’affichage. (Hérité de HotSpot)
Left	Obtient ou définit la coordonnée x du côté gauche de la région rectangulaire définie par cet RectangleHotSpot objet.
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 lorsqu’un HotSpot objet est cliqué. (Hérité de HotSpot)
PostBackValue	Obtient ou définit le nom de l’objet HotSpot à transmettre aux données d’événement lorsque le HotSpot clic est fait. (Hérité de HotSpot)
Right	Obtient ou définit la coordonnée x du côté droit de la région rectangulaire définie par cet RectangleHotSpot objet.
TabIndex	Obtient ou définit l’index de tabulation de la HotSpot région. (Hérité de HotSpot)
Target	Obtient ou définit la fenêtre ou le cadre cible dans lequel afficher le contenu de la page Web lié lorsqu’un HotSpot objet qui accède à une URL est cliqué. (Hérité de HotSpot)
Top	Obtient ou définit la coordonnée y du côté supérieur de la région rectangulaire définie par cet RectangleHotSpot objet.
ViewState	Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et de restaurer l’état d’affichage d’un HotSpot objet sur plusieurs requêtes pour la même page. (Hérité de HotSpot)

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetCoordinates()	Renvoie une chaîne qui représente les coordonnées x -and y du coin supérieur gauche d’un RectangleHotSpot objet et les coordonnées x et y de son coin inférieur droit.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
LoadViewState(Object)	Restaure l’état d’affichage précédemment enregistré de l’objet HotSpot sur l’objet. (Hérité de HotSpot)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (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 String représentation de cette instance d’un HotSpot objet. (Hérité de HotSpot)
TrackViewState()	Provoque le HotSpot suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans l’objet de l’objet StateBag . Cet objet est accessible via la ViewState propriété. (Hérité de HotSpot)

Implémentations d’interfaces explicites

Nom	Description
IStateManager.IsTrackingViewState	Obtient une valeur indiquant si l’objet HotSpot suit ses modifications d’état d’affichage. (Hérité de HotSpot)
IStateManager.LoadViewState(Object)	Restaure l’état d’affichage précédemment enregistré de l’objet HotSpot sur l’objet. (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 HotSpot région de suivre les modifications apportées à son état d’affichage. (Hérité de HotSpot)

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?