HotSpot.HotSpotMode Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Obtient ou définit le comportement d'un objet HotSpot d'un contrôle ImageMap suite à un clic sur HotSpot.

public:
 virtual property System::Web::UI::WebControls::HotSpotMode HotSpotMode { System::Web::UI::WebControls::HotSpotMode get(); void set(System::Web::UI::WebControls::HotSpotMode value); };

public virtual System.Web.UI.WebControls.HotSpotMode HotSpotMode { get; set; }

member this.HotSpotMode : System.Web.UI.WebControls.HotSpotMode with get, set

Public Overridable Property HotSpotMode As HotSpotMode

Valeur de propriété

HotSpotMode

Une des valeurs d'énumération HotSpotMode. La valeur par défaut est Default.

Exceptions

ArgumentOutOfRangeException

Le type spécifié ne fait pas partie des valeurs d'énumération HotSpotMode.

Remarques

Utilisez la HotSpotMode propriété pour spécifier le comportement d’un HotSpot objet dans un ImageMap contrôle lorsque l’utilisateur HotSpot clique sur. Cette propriété est définie à l’aide de l’une des valeurs d’énumération HotSpotMode . Le tableau suivant répertorie les valeurs possibles.

Valeur	Description
NotSet	HotSpot utilise le comportement défini par la propriété ImageMap du contrôle HotSpotMode. Si le ImageMap contrôle ne définit pas le comportement, les HotSpot objets accèdent à une URL.
Inactive	HotSpot ne possède pas de comportement.
Navigate	HotSpot navigue vers une URL.
PostBack	HotSpot génère une publication sur le serveur.

Vous pouvez spécifier HotSpot le comportement sur la HotSpotMode propriété du contrôle ou sur la HotSpotMode propriété de chaque objet individuel HotSpot . Si les deux propriétés sont définies, la HotSpotMode propriété spécifiée sur chaque objet individuel HotSpot est prioritaire sur la HotSpotMode propriété du ImageMap contrôle.

Si vous spécifiez HotSpotMode.NotSet pour la HotSpotMode propriété d’un objet individuelHotSpot, le HotSpot obtient son comportement à partir de la propriété du HotSpotMode contrôle contenantImageMap. Dans ce scénario, si la ImageMap propriété du HotSpotMode contrôle n’est pas définie sur une valeur ou est définie sur HotSpotMode.NotSet, le comportement par défaut consiste à accéder à une URL.

Si vous spécifiez HotSpotMode.Navigate pour la HotSpotMode propriété d’un HotSpot objet, l’objet HotSpot accède à une URL lorsque vous cliquez sur la région de point chaud. Utilisez la NavigateUrl propriété pour spécifier l’URL à laquelle accéder.

Si vous spécifiez pour la HotSpotMode propriété d’un HotSpot objet, l’objet HotSpot génère une publication sur le serveur lorsque HotSpot l’utilisateur clique HotSpotMode.PostBack sur. Utilisez la PostBackValue propriété pour spécifier un nom pour .HotSpot Ce nom sera transmis dans les données d’événement ImageMapEventArgs lorsqu’un événement de publication se produit. Lorsque vous cliquez sur une publication HotSpot , l’événement Click est déclenché. Pour contrôler par programmation les actions effectuées lorsque vous cliquez sur une publication HotSpot , fournissez un gestionnaire d’événements pour l’événement Click .

Pour que tous les HotSpot objets d’un ImageMap contrôle aient le même comportement, définissez la HotSpot.HotSpotMode propriété sur chaque objet individuel HotSpot sur HotSpotMode.NotSet ou ne spécifiez pas de valeur pour la HotSpot.HotSpotMode propriété .

Pour spécifier différents comportements pour HotSpot les objets d’un ImageMap contrôle, définissez la HotSpot.HotSpotMode propriété sur chaque objet HotSpotMode.Navigateindividuel HotSpot sur , HotSpotMode.PostBackou HotSpotMode.Inactive.

Notes

Si la propriété d’un ImageMapImageMap.HotSpotMode contrôle ou la HotSpot.HotSpotMode propriété sur les HotSpot objets qu’il contient n’est pas définie sur une valeur ou sur HotSpotMode.NotSet, par défaut, le comportement est HotSpotMode.Navigate.

Si vous spécifiez HotSpotMode.Inactive pour la HotSpot.HotSpotMode propriété, l’objet HotSpot n’a aucun comportement lorsqu’il est cliqué. Vous pouvez utiliser cette valeur pour créer un point chaud inactif au sein d’un point chaud actif plus grand. Cette option est fournie pour vous permettre de créer des zones de point chaud plus complexes au sein d’un ImageMap contrôle.

Pour créer une zone inactive dans un point chaud actif, vous devez spécifier le point chaud inactif avant le point chaud actif dans le ImageMap contrôle. Par exemple, ce qui suit ImageMap définit un anneau actif en spécifiant un point chaud circulaire inactif dans un point chaud circulaire actif plus grand :

<asp:ImageMap ID="SaturnImage"
  ImageUrl="~/saturn.PNG"
  runat="server" OnClick="SaturnImage_Click">
  <asp:CircleHotSpot AlternateText="planet" HotSpotMode=PostBack
    PostBackValue="planet" Radius=40 X=100 Y=100 />
  <asp:CircleHotSpot HotSpotMode=Inactive
    Radius=60 X=100 Y=100 />
  <asp:CircleHotSpot AlternateText="rings" HotSpotMode=PostBack
    PostBackValue="rings" Radius=80 X=100 Y=100 />
</asp:ImageMap>

Voir aussi

• HotSpotMode
• ImageMap
• HotSpotMode
• Contrôle de serveur web ImageMap