.NET Framework Class Library HotSpotCollection Class Represents a collection of HotSpot objects inside an ImageMap control. This class cannot be inherited.
Inheritance Hierarchy
Namespace:
System.Web.UI.WebControls
Assembly:
System.Web (in System.Web.dll)
Syntax
Public NotInheritable Class HotSpotCollection _
Inherits StateManagedCollection
public sealed class HotSpotCollection : StateManagedCollection
public ref class HotSpotCollection sealed : public StateManagedCollection
[<Sealed>]
type HotSpotCollection =
class
inherit StateManagedCollection
end
The HotSpotCollection type exposes the following members.
Constructors
Properties
Methods
|
| Name | Description |
|---|
.gif) | Add | Appends a specified HotSpot object to the end of the HotSpotCollection collection. | | Clear | Removes all items from the StateManagedCollection collection. (Inherited from StateManagedCollection.) | | CopyTo | Copies the elements of the StateManagedCollection collection to an array, starting at a particular array index. (Inherited from StateManagedCollection.) | .gif) | CreateKnownType | When overridden in a derived class, creates an instance of a class that implements IStateManager. The type of object created is based on the specified member of the collection returned by the GetKnownTypes method. (Inherited from StateManagedCollection.) | | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) | | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) | | GetEnumerator | Returns an iterator that iterates through the StateManagedCollection collection. (Inherited from StateManagedCollection.) | | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) | | GetKnownTypes | When overridden in a derived class, gets an array of IStateManager types that the StateManagedCollection collection can contain. (Inherited from StateManagedCollection.) | | GetType | Gets the Type of the current instance. (Inherited from Object.) | | Insert | Inserts a specified HotSpot object into the HotSpotCollection collection at the specified index location. | | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) | | OnClear | When overridden in a derived class, performs additional work before the Clear method removes all items from the collection. (Inherited from StateManagedCollection.) | | OnClearComplete | When overridden in a derived class, performs additional work after the Clear method finishes removing all items from the collection. (Inherited from StateManagedCollection.) | | OnInsert | When overridden in a derived class, performs additional work before the Insert(Int32, Object) or Add(Object) method adds an item to the collection. (Inherited from StateManagedCollection.) | | OnInsertComplete | When overridden in a derived class, performs additional work after the Insert(Int32, Object) or Add(Object) method adds an item to the collection. (Inherited from StateManagedCollection.) | | OnRemove | When overridden in a derived class, performs additional work before the Remove(Object) or RemoveAt(Int32) method removes the specified item from the collection. (Inherited from StateManagedCollection.) | | OnRemoveComplete | When overridden in a derived class, performs additional work after the Remove(Object) or RemoveAt(Int32) method removes the specified item from the collection. (Inherited from StateManagedCollection.) | | OnValidate | When overridden in a derived class, validates an element of the StateManagedCollection collection. (Inherited from StateManagedCollection.) | | Remove | Removes the specified HotSpot object from the HotSpotCollection collection. | | RemoveAt | Removes the HotSpot object at the specified index location from the collection. | | SetDirty | Forces the entire StateManagedCollection collection to be serialized into view state. (Inherited from StateManagedCollection.) | | SetDirtyObject | When overridden in a derived class, instructs an object contained by the collection to record its entire state to view state, rather than recording only change information. (Inherited from StateManagedCollection.) | | ToString | Returns a string that represents the current object. (Inherited from Object.) |
Top
Explicit Interface Implementations
Remarks
The HotSpotCollection class represents a collection that enables an ImageMap control to maintain a list of the HotSpot objects it contains. Use the Add method to add a specified HotSpot object to the collection at the end of an ordinal index array. Use the Insert method to add a HotSpot object to the collection at a specified index location. Use the Item indexer to directly access a HotSpot object in the collection at a specified index, using simple array notation. Use the Remove method to remove a HotSpot object from the end of the collection. Use the RemoveAt method to remove a HotSpot object from a specified index location.
Examples
The following code example demonstrates how to programmatically create an ImageMap control and add two CircleHotSpot objects to it. The HotSpots property is used to access the HotSpotCollection collection for the ImageMap control and add the CircleHotSpot objects to it. For this example to work correctly, you must supply your own image for the ImageUrl property and update the path to the image appropriately so that the application can locate it.
<%@ 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 Page_Load(ByVal sender As Object, ByVal e As EventArgs)
' Programmatically create an ImageMap control.
Dim Shop As New ImageMap
Shop.ImageUrl = "Images/ShopChoice.jpg"
Shop.AlternateText = "Shopping choices"
' Add the ImageMap control to the
' Controls collection of the page.
Page.Controls.Add(Shop)
' Programmatically create a CircleHotSpot object.
Dim Circle1 As New CircleHotSpot
Circle1.HotSpotMode = HotSpotMode.Navigate
Circle1.NavigateUrl = "http://www.tailspintoys.com"
Circle1.X = 145
Circle1.Y = 120
Circle1.Radius = 75
Circle1.AlternateText = "Shop for toys"
' Add Circle1 to the ImageMap's HotSpotCollection.
Shop.HotSpots.Add(Circle1)
' Programmatically create a second CircleHotSpot object.
Dim Circle2 As New CircleHotSpot
Circle2.HotSpotMode = HotSpotMode.Navigate
Circle2.NavigateUrl = "http://www.cohowinery.com"
Circle2.X = 145
Circle2.Y = 290
Circle2.Radius = 75
Circle2.AlternateText = "Shop for wine"
' Add Circle2 to the ImageMap's HotSpotCollection.
Shop.HotSpots.Add(Circle2)
End Sub
</script>
<html >
<head id="head1" runat="server">
<title>ImageMap Class VB Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageMap Class VB Constructor Example</h3>
<h4>Shopping Choices:</h4>
</form>
</body>
</html>
<%@ 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 Page_Load (Object sender, EventArgs e)
{
// Programmatically create an ImageMap control.
ImageMap Shop = new ImageMap();
// Set properties on the ImageMap control.
Shop.ImageUrl = "Images/ShopChoice.jpg";
Shop.AlternateText = "Shopping choices";
// Add the ImageMap control to the
// Controls collection of the page.
Page.Controls.Add(Shop);
// Programmatically create a CircleHotSpot object.
CircleHotSpot Circle1 = new CircleHotSpot();
Circle1.HotSpotMode = HotSpotMode.Navigate;
Circle1.NavigateUrl = "http://www.tailspintoys.com";
Circle1.X = 145;
Circle1.Y = 120;
Circle1.Radius = 75;
Circle1.AlternateText = "Shop for toys";
// Add Circle1 to the ImageMap's HotSpotCollection.
Shop.HotSpots.Add(Circle1);
// Programmatically create a second CircleHotSpot object.
CircleHotSpot Circle2 = new CircleHotSpot();
Circle2.HotSpotMode = HotSpotMode.Navigate;
Circle2.NavigateUrl = "http://www.cohowinery.com";
Circle2.X = 145;
Circle2.Y = 290;
Circle2.Radius = 75;
Circle2.AlternateText = "Shop for wine";
// Add Circle2 to the ImageMap's HotSpotCollection.
Shop.HotSpots.Add(Circle2);
}
</script>
<html >
<head id="head1" runat="server">
<title>ImageMap Class C# Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageMap Class C# Constructor Example</h3>
<h4>Shopping Choices:</h4>
</form>
</body>
</html>
Version Information
.NET FrameworkSupported in: 4, 3.5, 3.0, 2.0
Platforms
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role not supported), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Thread Safety
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
See Also
|
Bibliothèque de classes .NET Framework HotSpotCollection, classe Représente une collection d'objets HotSpot dans un contrôle ImageMap. Cette classe ne peut pas être héritée.
Hiérarchie d'héritage
Espace de noms :
System.Web.UI.WebControls
Assembly :
System.Web (dans System.Web.dll)
Syntaxe
Public NotInheritable Class HotSpotCollection _
Inherits StateManagedCollection
public sealed class HotSpotCollection : StateManagedCollection
public ref class HotSpotCollection sealed : public StateManagedCollection
[<Sealed>]
type HotSpotCollection =
class
inherit StateManagedCollection
end
Le type HotSpotCollection expose les membres suivants.
Constructeurs
Propriétés
Méthodes
|
| Nom | Description |
|---|
| Add | Ajoute un objet HotSpot spécifié à la fin de la collection HotSpotCollection. | | Clear | Supprime tous les éléments de la collection StateManagedCollection. (Hérité de StateManagedCollection.) | | CopyTo | Copie les éléments de la collection StateManagedCollection dans un tableau, en commençant au niveau d'un index de tableau particulier. (Hérité de StateManagedCollection.) | | CreateKnownType | En cas de substitution dans une classe dérivée, crée une instance d'une classe qui implémente IStateManager. Le type d'objet créé repose sur le membre spécifié de la collection retournée par la méthode GetKnownTypes. (Hérité de StateManagedCollection.) | | Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) | | Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) | | GetEnumerator | Retourne un itérateur qui itère au sein de la collection StateManagedCollection. (Hérité de StateManagedCollection.) | | GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) | | GetKnownTypes | En cas de substitution dans une classe dérivée, obtient un tableau de types IStateManager que la collection StateManagedCollection peut contenir. (Hérité de StateManagedCollection.) | | GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) | | Insert | Insère un objet HotSpot dans la collection HotSpotCollection à l'emplacement d'index spécifié. | | MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) | | OnClear | En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire avant que la méthode Clear supprime tous les éléments de la collection. (Hérité de StateManagedCollection.) | | OnClearComplete | En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire une fois tous les éléments de la collection supprimés par la méthode Clear. (Hérité de StateManagedCollection.) | | OnInsert | En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire avant la méthode Insert(Int32, Object) ou Add(Object) ajoute un élément à la collection. (Hérité de StateManagedCollection.) | | OnInsertComplete | En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire après que la méthode Insert(Int32, Object) ou Add(Object) a ajouté un élément à la collection. (Hérité de StateManagedCollection.) | | OnRemove | En cas de substitution dans une classe dérivée, exécute toute tâche supplémentaire avant que la méthode Remove(Object) ou RemoveAt(Int32) supprime l'élément spécifié de la collection. (Hérité de StateManagedCollection.) | | OnRemoveComplete | En cas de substitution dans une classe dérivée, exécute toute tâche supplémentaire après que la méthode Remove(Object) ou RemoveAt(Int32) a supprimé l'élément spécifié de la collection. (Hérité de StateManagedCollection.) | | OnValidate | En cas de substitution dans une classe dérivée, valide un élément de la collection StateManagedCollection. (Hérité de StateManagedCollection.) | | Remove | Supprime de la collection HotSpotCollection l'objet HotSpot spécifié. | | RemoveAt | Supprime de la collection l'objet HotSpot situé à l'emplacement d'index spécifié. | | SetDirty | Force la sérialisation de l'intégralité de la collection StateManagedCollection dans l'état d'affichage. (Hérité de StateManagedCollection.) | | SetDirtyObject | En cas de substitution dans une classe dérivée, commande à un object contenu dans la collection d'enregistrer l'intégralité de son état dans l'état d'affichage, plutôt que d'enregistrer uniquement des informations relatives aux modifications. (Hérité de StateManagedCollection.) | | ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
Début
Implémentations d'interface explicite
Notes
La classe HotSpotCollection représente une collection qui permet à un contrôle ImageMap de maintenir une liste des objets HotSpot qu'il contient. Utilisez la méthode Add pour ajouter un objet HotSpot spécifié à la collection à la fin d'un tableau d'index ordinal. Pour ajouter un objet Insert à la collection à un emplacement d'index spécifié, utilisez la méthode HotSpot. Utilisez l'indexeur Item pour accéder directement à un objet HotSpot de la collection situé à un index spécifié, à l'aide d'une simple notation de tableau. Utilisez la méthode Remove pour supprimer un objet HotSpot de la fin de la collection. Utilisez la méthode RemoveAt pour supprimer un objet HotSpot d'un emplacement d'index spécifié.
Exemples
L'exemple de code suivant montre comment créer par programme un contrôle ImageMap et lui ajouter deux objets CircleHotSpot. La propriété HotSpots est utilisée pour accéder à la collection HotSpotCollection du contrôle ImageMap et y ajouter les objets CircleHotSpot. Pour que cet exemple fonctionne correctement, vous devez fournir votre propre image pour la propriété ImageUrl et mettre à jour le chemin d'accès à l'image de façon à ce que l'application puisse la localiser.
<%@ 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 Page_Load(ByVal sender As Object, ByVal e As EventArgs)
' Programmatically create an ImageMap control.
Dim Shop As New ImageMap
Shop.ImageUrl = "Images/ShopChoice.jpg"
Shop.AlternateText = "Shopping choices"
' Add the ImageMap control to the
' Controls collection of the page.
Page.Controls.Add(Shop)
' Programmatically create a CircleHotSpot object.
Dim Circle1 As New CircleHotSpot
Circle1.HotSpotMode = HotSpotMode.Navigate
Circle1.NavigateUrl = "http://www.tailspintoys.com"
Circle1.X = 145
Circle1.Y = 120
Circle1.Radius = 75
Circle1.AlternateText = "Shop for toys"
' Add Circle1 to the ImageMap's HotSpotCollection.
Shop.HotSpots.Add(Circle1)
' Programmatically create a second CircleHotSpot object.
Dim Circle2 As New CircleHotSpot
Circle2.HotSpotMode = HotSpotMode.Navigate
Circle2.NavigateUrl = "http://www.cohowinery.com"
Circle2.X = 145
Circle2.Y = 290
Circle2.Radius = 75
Circle2.AlternateText = "Shop for wine"
' Add Circle2 to the ImageMap's HotSpotCollection.
Shop.HotSpots.Add(Circle2)
End Sub
</script>
<html >
<head id="head1" runat="server">
<title>ImageMap Class VB Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageMap Class VB Constructor Example</h3>
<h4>Shopping Choices:</h4>
</form>
</body>
</html>
<%@ 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 Page_Load (Object sender, EventArgs e)
{
// Programmatically create an ImageMap control.
ImageMap Shop = new ImageMap();
// Set properties on the ImageMap control.
Shop.ImageUrl = "Images/ShopChoice.jpg";
Shop.AlternateText = "Shopping choices";
// Add the ImageMap control to the
// Controls collection of the page.
Page.Controls.Add(Shop);
// Programmatically create a CircleHotSpot object.
CircleHotSpot Circle1 = new CircleHotSpot();
Circle1.HotSpotMode = HotSpotMode.Navigate;
Circle1.NavigateUrl = "http://www.tailspintoys.com";
Circle1.X = 145;
Circle1.Y = 120;
Circle1.Radius = 75;
Circle1.AlternateText = "Shop for toys";
// Add Circle1 to the ImageMap's HotSpotCollection.
Shop.HotSpots.Add(Circle1);
// Programmatically create a second CircleHotSpot object.
CircleHotSpot Circle2 = new CircleHotSpot();
Circle2.HotSpotMode = HotSpotMode.Navigate;
Circle2.NavigateUrl = "http://www.cohowinery.com";
Circle2.X = 145;
Circle2.Y = 290;
Circle2.Radius = 75;
Circle2.AlternateText = "Shop for wine";
// Add Circle2 to the ImageMap's HotSpotCollection.
Shop.HotSpots.Add(Circle2);
}
</script>
<html >
<head id="head1" runat="server">
<title>ImageMap Class C# Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageMap Class C# Constructor Example</h3>
<h4>Shopping Choices:</h4>
</form>
</body>
</html>
Informations de version
.NET FrameworkPris en charge dans : 4, 3.5, 3.0, 2.0
Plateformes
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Sécurité des threads
Tous les membres static ( Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Voir aussi
RéférenceAutres ressources
|