MapArea 類別

定義

命名空間:

System.Web.UI.DataVisualization.Charting

組件:

System.Web.DataVisualization.dll

表示對應區域。

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

繼承

Object

ChartElement

ChartNamedElement

MapArea

實作

IChartMapArea

備註

類別 MapArea 代表用戶端影像地圖的地圖區域，並對應至 HTML < AREA > 標籤。

物件 MapArea 會儲存在 類別中 MapAreasCollection 。

MapArea 物件分為兩種類型：

• 圖表專案時自動建立的地圖區域，例如資料點、數列、圖例專案或帶狀線線物件， 具有非空白 ToolTip 的 或 UrlMapAreaAttributes 屬性;請注意，也會建立用戶端影像地圖所需的其他 HTML 元素。 在此情況下，地圖區域的維度和位置會自動由圖表元素決定。 CustomizeMapAreas使用根 Chart 物件的 事件，在執行時間刪除或修改這些對應區域。

• 具有使用者定義圖形和座標的自訂地圖區域。 MapAreas使用 物件的 屬性 Chart ，在設計階段或執行時間新增這些自訂地圖區域。

如果屬性設定為 false ，則設定 IsMapEnabled 這個屬性不會有任何作用。 預設值是 true。

重要

若要使用先前描述 MapArea 的物件建立影像地圖， RenderType 物件的 屬性 Chart 必須設定為 ImageTag 。 使用二進位串流時，可以建立影像地圖，但必須使用另一種技術。

對於自訂 MapArea 物件， Shape 屬性會決定圖形，而 Coordinates 屬性會決定地圖區域的位置。

您可以針對所有地圖區域設定工具提示、超連結或屬性，例如 Target=_Blank 或 OnClick=「javascript：MyJavaScriptFunction () 」。

IsCustom使用 屬性來判斷地圖區域是否為自訂 MapArea 物件;也就是說，它是否有使用者定義的圖形和座標。

建構函式

MapArea()	初始化 MapArea 類別的新執行個體。
MapArea(MapAreaShape, String, Single[])	使用指定的圖形、URL 和座標，初始化 MapArea 類別的新執行個體。
MapArea(MapAreaShape, String, String, String, String, Single[], Object)	使用指定的圖形、工具提示文字、URL、屬性、回傳值、座標與標籤，初始化 MapArea 類別的新執行個體。
MapArea(String, GraphicsPath)	使用指定的 URL 和 MapArea 物件，初始化 GraphicsPath 類別的新執行個體。
MapArea(String, RectangleF)	使用指定的 URL 和 MapArea 結構，初始化 RectangleF 類別的新執行個體。
MapArea(String, String, String, String, GraphicsPath, Object)	使用指定的工具提示文字、URL、屬性、回傳值、路徑與標籤，初始化 MapArea 類別的新執行個體。
MapArea(String, String, String, String, RectangleF, Object)	使用指定的工具提示文字、URL、屬性、回傳值、矩形座標與標籤，初始化 MapArea 類別的新執行個體。

屬性

Coordinates	取得或設定 MapArea 物件的座標。
IsCustom	取得或設定值，指出對應區域是否為自訂。
MapAreaAttributes	取得或設定對應區域的屬性。
Name	取得或設定對應區域的名稱。
PostBackValue	取得或設定可在 Click 事件上處理的回傳值。
Shape	取得或設定 MapArea 物件的圖形。
Tag	取得或設定與這個圖表項目關聯的物件。 (繼承來源 ChartElement)
ToolTip	取得或設定對應區域的工具提示。
Url	取得或設定對應區域的目的 URL 或錨點。

方法

Dispose()	釋放 ChartElement 使用的資源。 (繼承來源 ChartElement)
Dispose(Boolean)	釋放 ChartElement 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 ChartElement)
Equals(Object)	判斷指定的 Object 是否等於目前的 ChartElement。 (繼承來源 ChartElement)
GetHashCode()	傳回特定型別的雜湊函式。 (繼承來源 ChartElement)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回表示目前 Object 的字串。 (繼承來源 ChartElement)