Freigeben über


MapArea Klasse

Definition

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 ToolTipUrl Objekt oder MapAreaAttributes eine 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)

Gilt für: