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 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
oderMapAreaAttributes
-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 false
festgelegt 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) |