MapIcon Klasse

Definition

Namespace:

Windows.UI.Xaml.Controls.Maps

Zeigt ein Bild an, z. B. eine Stecknadel mit optionalem Text in einem MapControl. Verwenden Sie das Standardimage, oder stellen Sie ein benutzerdefiniertes Image bereit.

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

Vererbung

Object Platform::Object IInspectable DependencyObject MapElement MapIcon

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Zeigen Sie Pushpins, Bilder und Shapes in MapControl an, indem Sie sie der MapElements-Auflistung hinzufügen.

• Zeigen Sie mithilfe der MapIcon-Klasse ein Bild wie z. B. eine Drucknadel mit optionalem Text an. Behalten Sie das Standardimage bei, oder stellen Sie ein benutzerdefiniertes Image bereit.
• Definieren und Anzeigen eines MapPolygons oder einer MapPolyline. Um XAML-Elemente im MapControl anzuzeigen, fügen Sie sie alternativ der Children-Auflistung hinzu.

Wenn Sie kein Höhen- und Höhenreferenzsystem explizit festlegen, wird das MapIcon auf der Oberfläche platziert.

Tipp

Wenn Sie ein MapIcon-Bild anzeigen, das auf eine bestimmte Position auf der Karte hinweist, z. B. eine Ortsmarkierung oder ein Pfeil, sollten Sie in Erwägung ziehen, den Wert der NormalizedAnchorPoint-Eigenschaft auf den ungefähren Standort des Zeigers auf dem Bild festzulegen. Wenn Sie den Wert von NormalizedAnchorPoint beim Standardwert (0, 0) belassen, der die obere linke Ecke des Bilds darstellt, führen Änderungen am ZoomLevel der Karte möglicherweise dazu, dass das Bild auf eine andere Position zeigt.

Konstruktoren

MapIcon()

Initialisiert eine neue instance der MapIcon-Klasse.

Eigenschaften

CollisionBehaviorDesired	Ruft das Verhalten eines MapIcon ab, wenn es aufgrund der Zoomstufe mit anderen Kartenfeatures kollidiert, oder legt es fest.
CollisionBehaviorDesiredProperty	Identifiziert die Abhängigkeitseigenschaft CollisionBehaviorDesired .
Dispatcher	Ruft den CoreDispatcher ab, dem dieses Objekt zugeordnet ist. CoreDispatcher stellt eine Funktion dar, die auf das DependencyObject im UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird. (Geerbt von DependencyObject)
Image	Ruft das Image für mapIcon ab oder legt es fest. Stellen Sie ein optionales benutzerdefiniertes Bild bereit, um das Standardbild poi (Point of Interest) zu ersetzen. Die folgenden Streamformate werden unterstützt: PNG : ein komprimierter PNG-formatierter Stream JPG – ein komprimierter JPG-formatierter Stream SVG – ein komprimierter SVG-formatierter Stream BMP – ein nicht komprimierter BMP-Formatdatenstrom Unformatierte RGB-Bytes. Die Größe des Bilds wird als quadratisch angenommen. Dies gilt nur für einen Stream mit einer integralen Quadratwurzellänge.
IsEnabled	Gibt an, ob Benutzer mit dem MapElement interagieren können. (Geerbt von MapElement)
Location	Ruft den geografischen Standort des MapIcon im MapControl ab oder legt diese fest. Der Standort ist der geografische Standort im MapControl , an dem der NormalizedAnchorPoint des MapIcon positioniert ist.
LocationProperty	Gibt die Location-Abhängigkeitseigenschaft an.
MapStyleSheetEntry	Ruft den Namen eines Eintrags im Stylesheet der Karte ab, den Sie auf dieses MapElement anwenden möchten, oder legt diesen fest. (Geerbt von MapElement)
MapStyleSheetEntryState	Ruft den Namen des Zustands dieses MapElement ab oder legt diesen fest. Wenn das Stylesheet eine Formatvorlage für diesen Zustand definiert, wird diese Formatvorlage auf dieses Element angewendet. Werte, die im Stylesheet für den Zustand definiert sind, überschreiben die im MapStyleSheetEntry definierten Werte. (Geerbt von MapElement)
MapTabIndex	Ruft einen Wert ab, der die Reihenfolge bestimmt, in der Elemente des MapControl-Steuerelements den Fokus erhalten, wenn der Benutzer durch diese Elemente navigiert, indem er die TAB-TASTE drückt, oder legt diesen fest. (Geerbt von MapElement)
NormalizedAnchorPoint	Ruft den Ankerpunkt des MapIcon ab oder legt diesen fest. Der Ankerpunkt ist der Punkt auf dem MapIcon , der an dem Punkt im MapControl positioniert ist, der durch die Location-Eigenschaft angegeben wird.
NormalizedAnchorPointProperty	Gibt die Abhängigkeitseigenschaft NormalizedAnchorPoint an.
Tag	Ruft einen beliebigen Objektwert ab, der zum Speichern benutzerdefinierter Informationen zu diesem Objekt verwendet werden kann, oder legt diesen fest. (Geerbt von MapElement)
Title	Ruft den optionalen Text des MapIcon ab oder legt diese fest.
TitleProperty	Gibt die Title-Abhängigkeitseigenschaft an.
Visible	Ruft einen Wert ab, der angibt, ob das MapElement im MapControl sichtbar ist, oder legt diesen fest. (Geerbt von MapElement)
ZIndex	Ruft den z-Index des MapElement ab oder legt diese fest. Ein MapElement mit einem höheren z-Index wird oben auf einem MapElement mit einem niedrigeren z-Index angezeigt. (Geerbt von MapElement)

Methoden

ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Gibt einen beliebigen Basiswert zurück, der für eine Abhängigkeitseigenschaft festgelegt wurde, was in Fällen gilt, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt ist. (Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registriert eine Benachrichtigungsfunktion zum Lauschen auf Änderungen an einer bestimmten DependencyProperty für dieses DependencyObject-instance. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest. (Geerbt von DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Bricht eine Änderungsbenachrichtigung ab, die zuvor registriert wurde, indem RegisterPropertyChangedCallback aufgerufen wurde. (Geerbt von DependencyObject)

Weitere Informationen

• MapElement
• Anzeigen von Karten mit 2D-, 3D- und Streetside-Ansichten