MapIcon Classe

Definição

Namespace:

Windows.UI.Xaml.Controls.Maps

Exibe uma imagem, como um pino de push com texto opcional em um MapControl. Use a imagem padrão ou forneça uma imagem personalizada.

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

Herança

Object Platform::Object IInspectable DependencyObject MapElement MapIcon

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Exiba pinos, imagens e formas no MapControl adicionando-os à coleção MapElements .

• Exiba uma imagem como um pushpin com texto opcional usando a classe MapIcon. Mantenha a imagem padrão ou forneça uma imagem personalizada.
• Defina e exiba um MapPolygon ou um MapPolyline. Como alternativa, para exibir elementos XAML no MapControl, adicione-os à coleção Children .

Se você não definir explicitamente uma Altitude e um AltitudeReferenceSystem, o MapIcon será colocado na superfície.

Dica

Quando exibir uma imagem MapIcon que aponta para um local específico no mapa - por exemplo, um botão de pressão ou uma seta - considere configurar o valor da propriedade NormalizedAnchorPoint para a localização aproximada do ponteiro na imagem. Caso você deixe o valor de NormalizedAnchorPoint no valor padrão (0, 0), o que representa o canto superior esquerdo da imagem, as mudanças em ZoomLevel do mapa podem deixar a imagem apontando para uma localização diferente.

Construtores

MapIcon()

Inicializa uma nova instância da classe MapIcon .

Propriedades

CollisionBehaviorDesired	Obtém ou define o comportamento de um MapIcon quando ele colide com outros recursos de mapa devido ao nível de zoom.
CollisionBehaviorDesiredProperty	Identifica a propriedade de dependência CollisionBehaviorDesired .
Dispatcher	Obtém o CoreDispatcher ao qual esse objeto está associado. O CoreDispatcher representa uma instalação que pode acessar DependencyObject no thread da interface do usuário mesmo que o código seja iniciado por um thread que não seja da interface do usuário. (Herdado de DependencyObject)
Image	Obtém ou define a imagem do MapIcon. Forneça uma imagem personalizada opcional para substituir a imagem poi (ponto de interesse padrão). Há suporte para os seguintes formatos de fluxo: PNG – um fluxo formatado png compactado JPG – um fluxo formatado jpg compactado SVG – um fluxo formatado de SVG compactado BMP – um fluxo de formato BMP não compactado Bytes RGB brutos. Presume-se que o tamanho da imagem seja quadrado. Isso só é válido para um fluxo com um comprimento de raiz quadrada integral.
IsEnabled	Indica se os usuários podem interagir com o MapElement. (Herdado de MapElement)
Location	Obtém ou define a localização geográfica do MapIcon no MapControl. O local é a localização geográfica no MapControl no qual o NormalizedAnchorPoint do MapIcon está posicionado.
LocationProperty	Identifica a propriedade de dependência Location .
MapStyleSheetEntry	Obtém ou define o nome de uma entrada na folha de estilos do mapa que você gostaria de aplicar a este MapElement. (Herdado de MapElement)
MapStyleSheetEntryState	Obtém ou define o nome do estado deste MapElement. Se a folha de estilos definir um estilo para esse estado, esse estilo será aplicado a esse elemento. Valores definidos na folha de estilos para os valores de substituição de estado definidos no MapStyleSheetEntry. (Herdado de MapElement)
MapTabIndex	Obtém ou define um valor que determina a ordem na qual os elementos do MapControl recebem foco quando o usuário navega por esses elementos pressionando a tecla Tab. (Herdado de MapElement)
NormalizedAnchorPoint	Obtém ou define o ponto de âncora do MapIcon. O ponto de âncora é o ponto no MapIcon que está posicionado no ponto no MapControl especificado pela propriedade Location .
NormalizedAnchorPointProperty	Identifica a propriedade de dependência NormalizedAnchorPoint .
Tag	Obtém ou define um valor de objeto arbitrário que pode ser usado para armazenar informações personalizadas sobre esse objeto. (Herdado de MapElement)
Title	Obtém ou define o texto opcional do MapIcon.
TitleProperty	Identifica a propriedade de dependência Title .
Visible	Obtém ou define um valor que indica se MapElement está visível no MapControl. (Herdado de MapElement)
ZIndex	Obtém ou define o índice z do MapElement. Um MapElement com um índice z mais alto é exibido na parte superior de um MapElement com um índice z mais baixo. (Herdado de MapElement)

Métodos

ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade de dependência. (Herdado de DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Retorna qualquer valor base estabelecido para uma propriedade de dependência, que se aplicaria nos casos em que uma animação não está ativa. (Herdado de DependencyObject)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject. (Herdado de DependencyObject)
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, se um valor local for definido. (Herdado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra uma função de notificação para escutar alterações em uma DependencyProperty específica nesta instância dependencyObject . (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência em um DependencyObject. (Herdado de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela uma notificação de alteração que foi registrada anteriormente chamando RegisterPropertyChangedCallback. (Herdado de DependencyObject)

Confira também

• MapElement
• Exibir mapas com modos de exibição 2D, 3D e Streetside