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에서 도입되었습니다.)

설명

MapElements 컬렉션에 압정, 이미지 및 도형을 추가하여 MapControl에 표시합니다.

• MapIcon 클래스를 사용하여 선택적 텍스트가 있는 압정과 같은 이미지를 표시합니다. 기본 이미지를 유지하거나 사용자 지정 이미지를 제공합니다.
• MapPolygon 또는 MapPolyline을 정의하고 표시합니다. 또는 MapControl에 XAML 요소를 표시하려면 Children 컬렉션에 추가합니다.

Altitude 및 AltitudeReferenceSystem을 명시적으로 설정하지 않으면 표면에 MapIcon이 놓입니다.

팁

지도에 있는 특정 위치를 가리키는 MapIcon 이미지(예제: 고정핀이나 화살표)를 표시할 경우 NormalizedAnchorPoint 속성의 값을 이미지에 표시되는 포인터의 대략적인 위치로 설정해 보세요. NormalizedAnchorPoint 값을 이미지의 오른쪽 위 모서리를 나타내는 기본값인 (0, 0)으로 유지하면 지도의 ZoomLevel을 변경할 경우 이미지가 다른 위치를 가리킬 수 있습니다.

생성자

MapIcon()

MapIcon 클래스의 새 instance 초기화합니다.

속성

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-index를 가져오거나 설정합니다. z-인덱스가 더 높은 MapElement 는 더 낮은 z-인덱스가 있는 MapElement 위에 표시됩니다. (다음에서 상속됨 MapElement)

메서드

ClearValue(DependencyProperty)	종속성 속성의 로컬 값을 지웁니다. (다음에서 상속됨 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	애니메이션이 활성화되지 않은 경우 적용되는 종속성 속성에 대해 설정된 모든 기본 값을 반환합니다. (다음에서 상속됨 DependencyObject)
GetValue(DependencyProperty)	DependencyObject에서 종속성 속성의 현재 유효 값을 반환합니다. (다음에서 상속됨 DependencyObject)
ReadLocalValue(DependencyProperty)	로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다. (다음에서 상속됨 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	이 DependencyObject instance 특정 DependencyProperty의 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다. (다음에서 상속됨 DependencyObject)
SetValue(DependencyProperty, Object)	DependencyObject에서 종속성 속성의 로컬 값을 설정합니다. (다음에서 상속됨 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	RegisterPropertyChangedCallback을 호출하여 이전에 등록된 변경 알림을 취소합니다. (다음에서 상속됨 DependencyObject)

추가 정보

• MapElement
• 2D, 3D 및 Streetside 뷰가 있는 지도 표시