MapArea Klasse

Definition

Stellt einen Zuordnungsbereich 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 Imagezuordnung dar und entspricht einem HTML AREA-Tag<>.

Die MapArea Objekte werden in der MapAreasCollection -Klasse gespeichert.

Es gibt zwei Arten von MapArea Objekten:

  • Zuordnungsbereiche, die automatisch erstellt werden, wenn ein Diagrammelement ( z. B. ein Datenpunkt-, Reihen-, Legendenelement- oder Striplinienobjekt ) über eine nicht leere ToolTip- Url oder MapAreaAttributes -Eigenschaft verfügt. 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 einer benutzerdefinierten Form und Koordinaten. Verwenden Sie die MapAreas -Eigenschaft des Chart -Objekts, um diese benutzerdefinierten Kartenbereiche zur Entwurfs- oder Laufzeit hinzuzufügen.

Das Festlegen dieser Eigenschaft hat keine Auswirkungen, wenn die IsMapEnabled -Eigenschaft auf falsefestgelegt ist. Der Standardwert ist true.

Wichtig

Um eine Imagezuordnung mit den zuvor beschriebenen MapArea Objekten zu erstellen, muss die RenderType -Eigenschaft des Chart -Objekts auf ImageTagfestgelegt werden. Es ist möglich, eine Imagemap zu erstellen, wenn Sie binäres Streaming verwenden, aber es muss eine andere Technik verwendet werden.

Bei benutzerdefinierten MapArea Objekten bestimmt die Shape -Eigenschaft die Form, 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 MapArea Objekt ist, d. h. ob er benutzerdefinierte Formen und Koordinaten aufweist.

Konstruktoren

MapArea()

Initialisiert eine neue Instanz der MapArea-Klasse.

MapArea(MapAreaShape, String, Single[])

Initialisiert eine neue Instanz der MapArea-Klasse mit der angegebenen Form, der angegebenen URL und den angegebenen Koordinaten.

MapArea(MapAreaShape, String, String, String, String, Single[], Object)

Initialisiert eine neue Instanz der MapArea-Klasse mit der angegebenen Form, dem angegebenen QuickInfo-Text, der angegebenen URL, den angegebenen Attributen, dem angegebenen Postbackwert, den angegebenen Koordinaten und dem angegebenen Tag.

MapArea(String, GraphicsPath)

Initialisiert eine neue Instanz der MapArea-Klasse mit der angegebenen URL und dem angegebenen GraphicsPath-Objekt.

MapArea(String, RectangleF)

Initialisiert eine neue Instanz der MapArea-Klasse mit der angegebenen URL und der angegebenen RectangleF-Struktur.

MapArea(String, String, String, String, GraphicsPath, Object)

Initialisiert eine neue Instanz der MapArea-Klasse mit dem angegebenen QuickInfo-Text, der angegebenen URL, den angegebenen Attributen, dem angegebenen Postbackwert, dem angegebenen Pfad und dem angegebenen Tag.

MapArea(String, String, String, String, RectangleF, Object)

Initialisiert eine neue Instanz der MapArea-Klasse mit dem angegebenen QuickInfo-Text, der angegebenen URL, den angegebenen Attributen, dem angegebenen Postbackwert, den angegebenen Rechteckkoordinaten und dem angegebenen Tag.

Eigenschaften

Coordinates

Ruft die Koordinaten eines MapArea-Objekts ab oder legt diese fest.

IsCustom

Ruft einen Wert ab, der angibt, ob der Zuordnungsbereich benutzerdefiniert ist, oder legt diesen fest.

MapAreaAttributes

Ruft die Attribute des Zuordnungsbereichs ab oder legt diese fest.

Name

Ruft den Namen des Zuordnungsbereichs ab oder legt diesen fest.

PostBackValue

Ruft den Postbackwert ab, der in einem Click-Ereignis verarbeitet werden kann, oder legt diesen fest.

Shape

Ruft die Form eines MapArea-Objekts ab oder legt diese fest.

Tag

Ruft ein Objekt ab, das dem Diagrammelement zugeordnet ist, oder legt dieses fest.

(Geerbt von ChartElement)
ToolTip

Ruft die QuickInfo für den Zuordnungsbereich ab oder legt diese fest.

Url

Ruft die Ziel-URL oder den Ankerpunkt des Zuordnungsbereichs ab oder legt diese(n) fest.

Methoden

Dispose()

Gibt die von der ChartElement verwendeten Ressourcen frei.

(Geerbt von ChartElement)
Dispose(Boolean)

Gibt die von ChartElement verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

(Geerbt von ChartElement)
Equals(Object)

Bestimmt, ob das angegebene Object und das aktuelle ChartElement gleich sind.

(Geerbt von ChartElement)
GetHashCode()

Gibt eine Hashfunktion für einen bestimmten Typ zurück.

(Geerbt von ChartElement)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Object-Objekt darstellt.

(Geerbt von ChartElement)

Gilt für: