Compartilhar via


MapIcon Classe

Definição

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.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
Herança
Object Platform::Object IInspectable DependencyObject MapElement MapIcon
Atributos

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)

Aplica-se a

Confira também