Freigeben über


MapIcon Klasse

Definition

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.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class MapIcon final : 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class MapIcon : 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

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)

Gilt für:

Weitere Informationen