MapArea Classe

Définition

Espace de noms:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Représente une zone de carte.

public ref class MapArea : System::Web::UI::DataVisualization::Charting::ChartNamedElement, System::Web::UI::DataVisualization::Charting::IChartMapArea

public class MapArea : System.Web.UI.DataVisualization.Charting.ChartNamedElement, System.Web.UI.DataVisualization.Charting.IChartMapArea

type MapArea = class
    inherit ChartNamedElement
    interface IChartMapArea

Public Class MapArea
Inherits ChartNamedElement
Implements IChartMapArea

Héritage

Object

ChartElement

ChartNamedElement

MapArea

Implémente

IChartMapArea

Remarques

La MapArea classe représente une zone de carte d’une carte d’images côté client et correspond à une balise HTML <AREA> .

Les MapArea objets sont stockés dans la MapAreasCollection classe.

Il existe deux types d’objets MapArea :

• Les zones cartographiques créées automatiquement lorsqu’un élément de graphique ( par exemple, un point de données, une série, un élément de légende ou un objet de ligne de bande) possèdent un objet non vide ToolTipou UrlMapAreaAttributes une propriété ; notez que d’autres éléments HTML requis pour une carte d’images côté client sont également créés. Dans ce cas, les dimensions et l’emplacement d’une zone de carte sont automatiquement déterminés par l’élément de graphique. Utilisez l’événement CustomizeMapAreas de l’objet racine Chart pour supprimer ou modifier ces zones de carte au moment de l’exécution.

• Zones de carte personnalisées qui ont une forme et des coordonnées définies par l’utilisateur. Utilisez la MapAreas propriété de l’objet Chart pour ajouter ces zones de carte personnalisées au moment du design ou au moment de l’exécution.

La définition de cette propriété n’aura aucun effet si la IsMapEnabled propriété est définie falsesur . La valeur par défaut est true.

Important

Pour créer une carte d’images à l’aide des objets précédemment décrits MapArea , la RenderType propriété de l’objet Chart doit être définie sur ImageTag. Il est possible de créer une carte d’images lors de l’utilisation du streaming binaire, mais une autre technique doit être utilisée.

Pour les objets personnalisés MapArea , la Shape propriété détermine la forme et la Coordinates propriété détermine l’emplacement de la zone de carte.

Les info-bulles, les liens hypertexte ou les attributs, tels que Target=_Blank ou OnClick="javascript :MyJavaScriptFunction() », peuvent être définis pour toutes les zones cartographiques.

Utilisez la IsCustom propriété pour déterminer si une zone de carte est un objet personnalisé MapArea ; autrement dit, si elle a une forme et des coordonnées définies par l’utilisateur.

Constructeurs

Nom	Description
MapArea()	Initialise une nouvelle instance de la classe MapArea.
MapArea(MapAreaShape, String, Single[])	Initialise une nouvelle instance de la MapArea classe avec la forme, l’URL et les coordonnées spécifiées.
MapArea(MapAreaShape, String, String, String, String, Single[], Object)	Initialise une nouvelle instance de la MapArea classe avec la forme spécifiée, le texte d’info-bulle, l’URL, les attributs, la valeur de publication, les coordonnées et la balise spécifiés.
MapArea(String, GraphicsPath)	Initialise une nouvelle instance de la MapArea classe avec l’URL et GraphicsPath l’objet spécifiés.
MapArea(String, RectangleF)	Initialise une nouvelle instance de la MapArea classe avec l’URL et RectangleF la structure spécifiées.
MapArea(String, String, String, String, GraphicsPath, Object)	Initialise une nouvelle instance de la MapArea classe avec le texte d’info-bulle, l’URL, les attributs, la valeur de publication, le chemin d’accès et la balise spécifiés.
MapArea(String, String, String, String, RectangleF, Object)	Initialise une nouvelle instance de la MapArea classe avec le texte d’info-bulle, l’URL, les attributs, la valeur de publication, les coordonnées de rectangle et la balise spécifiés.

Propriétés

Nom	Description
Coordinates	Obtient ou définit les coordonnées d’un MapArea objet.
IsCustom	Obtient ou définit une valeur qui indique si la zone de carte est personnalisée.
MapAreaAttributes	Obtient ou définit les attributs de la zone de carte.
Name	Obtient ou définit le nom de la zone de carte.
PostBackValue	Obtient ou définit la valeur de publication qui peut être traitée sur un Click événement.
Shape	Obtient ou définit la forme d’un MapArea objet.
Tag	Obtient ou définit un objet associé à cet élément de graphique. (Hérité de ChartElement)
ToolTip	Obtient ou définit l’info-bulle de la zone de carte.
Url	Obtient ou définit l’URL de destination ou le point d’ancrage de la zone de carte.

Méthodes

Nom	Description
Dispose()	Libère les ressources utilisées par le ChartElement. (Hérité de ChartElement)
Dispose(Boolean)	Libère les ressources non managées utilisées par les ChartElement ressources gérées et libère éventuellement les ressources managées. (Hérité de ChartElement)
Equals(Object)	Détermine si le spécifié Object est égal à l’actuel ChartElement. (Hérité de ChartElement)
GetHashCode()	Retourne une fonction de hachage pour un type particulier. (Hérité de ChartElement)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente le fichier actif Object. (Hérité de ChartElement)