MapIcon 類別

定義

命名空間:

Windows.UI.Xaml.Controls.Maps

顯示影像，例如 MapControl上具有選擇性文字的圖釘。 使用預設映射或提供自訂映射。

public ref class MapIcon sealed : MapElement

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class MapIcon final : MapElement

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class MapIcon : MapElement

Public NotInheritable Class MapIcon
Inherits MapElement

繼承

Object Platform::Object IInspectable DependencyObject MapElement MapIcon

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

將圖釘、影像和圖形新增至MapElements集合，以顯示MapControl上的圖釘、影像和圖形。

• 使用 MapIcon 類別顯示 圖 釘，例如具有選擇性文字的圖釘。 保留預設映射或提供自訂映射。
• 定義並顯示 MapPolygon 或 MapPolyline。 或者，若要在 MapControl上顯示 XAML 元素，請將它們新增至其 Children 集合。

如果您沒有明確設定高度和 AltitudeReferenceSystem，則 MapIcon 將會放在表面上。

提示

當您在地圖上顯示指向某特定位置的 MapIcon 影像 (例如圖釘或箭頭) 時，請考慮將 NormalizedAnchorPoint 屬性的值設定為影像上概略的指標位置。 如果您讓 NormalizedAnchorPoint 的值保留其預設值 (0, 0)，該值代表影像的左上角，變更地圖的 ZoomLevel 可能會讓影像指向不同的位置。

建構函式

MapIcon()

初始化 MapIcon 類別的新實例。

屬性

CollisionBehaviorDesired	取得或設定 MapIcon 在因縮放層級而與其他地圖特徵衝突時的行為。
CollisionBehaviorDesiredProperty	識別 CollisionBehaviorDesired 相依性屬性。
Dispatcher	取得這個 物件相關聯的 CoreDispatcher 。 CoreDispatcher代表可在 UI 執行緒上存取DependencyObject的功能，即使程式碼是由非 UI 執行緒起始也一樣。 (繼承來源 DependencyObject)
Image	取得或設定 MapIcon的影像。 提供選擇性的自訂映射，以取代 POI) 映射 (預設景點。 支援下列資料流程格式： PNG - 壓縮的 PNG 格式資料流程 JPG - 壓縮的 JPG 格式資料流程 SVG - 壓縮的 SVG 格式資料流程 BMP - 未壓縮的 BMP 格式資料流程 原始 RGB 位元組。 影像的大小假設為正方形。 這只適用于具有整數平方根長度的資料流程。
IsEnabled	指出使用者是否可以與 MapElement互動。 (繼承來源 MapElement)
Location	取得或設定MapControl上MapIcon的地理位置。 位置是MapControl上的地理位置，MapIcon的NormalizedAnchorPoint位於該位置。
LocationProperty	識別 Location 相依性屬性。
MapStyleSheetEntry	取得或設定您要套用至此 MapElement之地圖樣式表單中的專案名稱。 (繼承來源 MapElement)
MapStyleSheetEntryState	取得或設定這個 MapElement狀態的名稱。 如果樣式表單定義該狀態的樣式，該樣式會套用至這個專案。 在樣式表單中為 MapStyleSheetEntry中定義的狀態覆寫值所定義的值。 (繼承來源 MapElement)
MapTabIndex	取得或設定值，這個值會決定當使用者按下 Tab 鍵流覽這些專案時 ，MapControl 的元素接收焦點的順序。 (繼承來源 MapElement)
NormalizedAnchorPoint	取得或設定 MapIcon的錨點。 錨點是MapIcon上的點，該點位於Location屬性所指定的MapControl點。
NormalizedAnchorPointProperty	識別 NormalizedAnchorPoint 相依性屬性。
Tag	取得或設定可用來儲存此物件之自訂資訊的任意物件值。 (繼承來源 MapElement)
Title	取得或設定 MapIcon的選擇性文字。
TitleProperty	識別 Title 相依性屬性。
Visible	取得或設定值，指出MapControl上是否顯示MapElement。 (繼承來源 MapElement)
ZIndex	取得或設定 MapElement的 z 索引。 具有較高 z 索引的 MapElement 會顯示在具有較低 z 索引的 MapElement 上方。 (繼承來源 MapElement)

方法

ClearValue(DependencyProperty)	清除相依性屬性的本機值。 (繼承來源 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	傳回為相依性屬性建立的任何基底值，如果動畫未使用中，則適用此屬性。 (繼承來源 DependencyObject)
GetValue(DependencyProperty)	從 DependencyObject傳回相依性屬性的目前有效值。 (繼承來源 DependencyObject)
ReadLocalValue(DependencyProperty)	如果已設定本機值，則傳回相依性屬性的本機值。 (繼承來源 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	註冊通知函式，以接聽此DependencyObject實例上特定DependencyProperty的變更。 (繼承來源 DependencyObject)
SetValue(DependencyProperty, Object)	設定 DependencyObject上相依性屬性的本機值。 (繼承來源 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消先前透過呼叫 RegisterPropertyChangedCallback註冊的變更通知。 (繼承來源 DependencyObject)

另請參閱

• MapElement
• 顯示地圖的 2D、3D 和 Streetside 檢視