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 で導入)

注釈

MapControl にプッシュピン、画像、図形を表示するには、それらを MapElements コレクションに追加します。

• MapIcon クラスを使用して、省略可能なテキストを含むプッシュピンなどの 画像 を表示します。 既定のイメージをそのまま使用するか、カスタム イメージを指定します。
• MapPolygon または MapPolyline を定義して表示します。 または、 MapControl に XAML 要素を表示するには、それらを Children コレクションに追加します。

Altitude と AltitudeReferenceSystem を明示的に設定しない場合、MapIcon はサーフェスに配置されます。

ヒント

地図上の特定の場所を指す MapIcon 画像 (たとえば、プッシュピンや矢印など) を表示する場合は、NormalizedAnchorPoint プロパティの値を画像上にあるポインターのおおよその位置に設定することを検討してください。 NormalizedAnchorPoint の値を、画像の左上隅を示す既定値 (0, 0) のままにした場合、地図の ZoomLevel を変更すると、画像が別の場所を示した状態になる可能性があります。

コンストラクター

MapIcon()

MapIcon クラスの新しいインスタンスを初期化します。

プロパティ

CollisionBehaviorDesired	ズーム レベルが原因で他のマップ フィーチャと競合した場合の MapIcon の 動作を取得または設定します。
CollisionBehaviorDesiredProperty	CollisionBehaviorDesired 依存関係プロパティを識別します。
Dispatcher	このオブジェクトが関連付けられている CoreDispatcher を取得します。 CoreDispatcher は、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の DependencyObject にアクセスできる機能を表します。 (継承元 DependencyObject)
Image	MapIcon のイメージを取得または設定します。 既定の目的地 (POI) イメージを置き換えるオプションのカスタム イメージを指定します。 次のストリーム形式がサポートされています。 PNG - 圧縮された PNG 形式のストリーム JPG - 圧縮された JPG 形式のストリーム SVG - 圧縮された SVG 形式のストリーム BMP - 圧縮されていない BMP 形式ストリーム 未加工の RGB バイト。 イメージのサイズは正方形と見なされます。 これは、整数平方根長のストリームでのみ有効です。
IsEnabled	ユーザーが MapElement と対話できるかどうかを示します。 (継承元 MapElement)
Location	MapControl 上の MapIcon の地理的な場所を取得または設定します。 場所は、 MapIcon の NormalizedAnchorPoint が配置されている MapControl 上の地理的な場所です。
LocationProperty	Location 依存関係プロパティを識別します。
MapStyleSheetEntry	この MapElement に適用するマップのスタイル シート内のエントリの名前を取得または設定します。 (継承元 MapElement)
MapStyleSheetEntryState	この MapElement の状態の名前を取得または設定します。 スタイル シートでその状態のスタイルが定義されている場合、そのスタイルがこの要素に適用されます。 状態のスタイル シートで定義されている値は、 MapStyleSheetEntry で定義されている値をオーバーライドします。 (継承元 MapElement)
MapTabIndex	ユーザーが Tab キーを押してこれらの要素を移動したときに MapControl の要素がフォーカスを受け取る順序を決定する値を取得または設定します。 (継承元 MapElement)
NormalizedAnchorPoint	MapIcon のアンカー ポイントを取得または設定します。 アンカー ポイントは、Location プロパティで指定された MapControl 上のポイントに位置する MapIcon 上のポイントです。
NormalizedAnchorPointProperty	NormalizedAnchorPoint 依存関係プロパティを識別します。
Tag	このオブジェクトに関するカスタム情報を格納するために使用できる任意のオブジェクト値を取得または設定します。 (継承元 MapElement)
Title	MapIcon の省略可能なテキストを取得または設定します。
TitleProperty	Title 依存関係プロパティを識別します。
Visible	MapElement が MapControl に表示されるかどうかを示す値を取得または設定します。 (継承元 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 ビューでの地図の表示