MapArea Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt einen Kartenbereich dar.
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
- Vererbung
- Implementiert
Hinweise
Die MapArea Klasse stellt einen Kartenbereich einer clientseitigen Bildzuordnung dar und entspricht einem HTML AREA-Tag<>.
Die MapArea Objekte werden in der MapAreasCollection Klasse gespeichert.
Es gibt zwei Objekttypen MapArea :
Zuordnungsbereiche, die automatisch erstellt werden, wenn ein Diagrammelement – z. B. ein Datenpunkt, eine Datenreihe, ein Legendenelement oder ein Striplinienobjekt – ein nicht leeres
ToolTipUrlObjekt oderMapAreaAttributeseine Eigenschaft aufweist. Beachten Sie, dass auch andere HTML-Elemente erstellt werden, die für eine clientseitige Bildzuordnung erforderlich sind. In diesem Fall werden die Dimensionen und die Position eines Kartenbereichs automatisch durch das Diagrammelement bestimmt. Verwenden Sie das CustomizeMapAreas Ereignis des Stammobjekts Chart , um diese Zuordnungsbereiche zur Laufzeit zu löschen oder zu ändern.Benutzerdefinierte Kartenbereiche mit benutzerdefinierten Shapes und Koordinaten. Verwenden Sie die MapAreas Eigenschaft des Chart Objekts, um diese benutzerdefinierten Kartenbereiche zur Entwurfszeit oder Laufzeit hinzuzufügen.
Das Festlegen dieser Eigenschaft hat keine Auswirkung, wenn die IsMapEnabled Eigenschaft auf false. Der Standardwert ist true.
Von Bedeutung
Um eine Bildzuordnung mit den zuvor beschriebenen MapArea Objekten zu erstellen, muss die RenderType Eigenschaft des Chart Objekts auf festgelegt ImageTagwerden. Es ist möglich, beim Verwenden von binärem Streaming eine Bildzuordnung zu erstellen, aber eine andere Technik muss verwendet werden.
Bei benutzerdefinierten MapArea Objekten bestimmt die Shape Eigenschaft das Shape, und die Coordinates Eigenschaft bestimmt die Position des Kartenbereichs.
QuickInfos, Hyperlinks oder Attribute, z. B. Target=_Blank oder OnClick="javascript:MyJavaScriptFunction()", können für alle Kartenbereiche festgelegt werden.
Verwenden Sie die IsCustom Eigenschaft, um zu bestimmen, ob ein Kartenbereich ein benutzerdefiniertes Objekt ist. Das heißt, ob es benutzerdefinierte MapArea Form und Koordinaten enthält.
Konstruktoren
| Name | Beschreibung |
|---|---|
| MapArea() |
Initialisiert eine neue Instanz der MapArea-Klasse. |
| MapArea(MapAreaShape, String, Single[]) |
Initialisiert eine neue Instanz der MapArea Klasse mit der angegebenen Form, URL und Koordinaten. |
| MapArea(MapAreaShape, String, String, String, String, Single[], Object) |
Initialisiert eine neue Instanz der MapArea Klasse mit dem angegebenen Shape, QuickInfo-Text, URL, Attributen, Postbackwert, Koordinaten und Tag. |
| MapArea(String, GraphicsPath) |
Initialisiert eine neue Instanz der MapArea Klasse mit der angegebenen URL und GraphicsPath dem angegebenen Objekt. |
| MapArea(String, RectangleF) |
Initialisiert eine neue Instanz der MapArea Klasse mit der angegebenen URL und RectangleF Struktur. |
| MapArea(String, String, String, String, GraphicsPath, Object) |
Initialisiert eine neue Instanz der MapArea Klasse mit dem angegebenen QuickInfo-Text, url, Attributen, Postbackwert, Pfad und Tag. |
| MapArea(String, String, String, String, RectangleF, Object) |
Initialisiert eine neue Instanz der MapArea Klasse mit dem angegebenen QuickInfo-Text, url, Attributen, Postbackwert, Rechteckkoordinaten und Tag. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Coordinates |
Dient zum Abrufen oder Festlegen der Koordinaten eines MapArea Objekts. |
| IsCustom |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Kartenbereich benutzerdefiniert ist. |
| MapAreaAttributes |
Ruft die Attribute des Kartenbereichs ab oder legt diese fest. |
| Name |
Dient zum Abrufen oder Festlegen des Namens des Kartenbereichs. |
| PostBackValue |
Dient zum Abrufen oder Festlegen des Postbackwerts, der für ein Click Ereignis verarbeitet werden kann. |
| Shape |
Dient zum Abrufen oder Festlegen der Form eines MapArea Objekts. |
| Tag |
Dient zum Abrufen oder Festlegen eines Objekts, das diesem Diagrammelement zugeordnet ist. (Geerbt von ChartElement) |
| ToolTip |
Dient zum Abrufen oder Festlegen der QuickInfo für den Kartenbereich. |
| Url |
Dient zum Abrufen oder Festlegen der Ziel-URL oder des Ankerpunkts des Kartenbereichs. |
Methoden
| Name | Beschreibung |
|---|---|
| Dispose() |
Gibt die von der ChartElement. (Geerbt von ChartElement) |
| Dispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die von den ChartElement verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von ChartElement) |
| Equals(Object) |
Bestimmt, ob der angegebene Object Wert gleich dem aktuellen ChartElementist. (Geerbt von ChartElement) |
| GetHashCode() |
Gibt eine Hashfunktion für einen bestimmten Typ zurück. (Geerbt von ChartElement) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die die aktuelle Objectdarstellt. (Geerbt von ChartElement) |