다음을 통해 공유


MapControl.TryZoomInAsync 메서드

정의

확대하는 비동기 작업을 시작하여 맵의 ZoomLevel 을 하나씩 늘입니다.

public:
 virtual IAsyncOperation<bool> ^ TryZoomInAsync() = TryZoomInAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<bool> TryZoomInAsync();
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<bool> TryZoomInAsync();
function tryZoomInAsync()
Public Function TryZoomInAsync () As IAsyncOperation(Of Boolean)

반환

작업의 결과를 포함합니다. 작업이 성공적으로 완료되면 true 입니다. 그렇지 않으면 false입니다.

특성

설명

경고

3D 보기를 사용하여 ZoomLevel 을 변경하지 않는 것이 좋습니다. MapControl의 보기가 "직선"으로 보이지 않는 경우 ZoomLevel 의 변경으로 인해 예측할 수 없는 동작이 발생할 수 있습니다.

ZoomLevel 은 2D 보기용입니다. 3D 보기를 사용하여 "확대/축소" 효과를 구현하려면 MapControl의 TrySetSceneAsync 메서드를 사용하여 카메라를 더 가깝게 이동합니다. 먼저 MapCamera 개체에서 더 가까운 위치를 설정합니다. 다음으로, MapCameraCreateFromCamera에 전달하여 새 MapScene을 만듭니다. 마지막으로 새 MapScene을TrySetSceneAsync에 전달하여 확대/축소를 시작합니다. 즉시 확대하거나 MapAnimationKind 를 지정하여 애니메이션 "플라이 인"을 만들 수 있습니다.

MaxZoomLevelMinZoomLevel 속성에서 보고하는 ZoomLevel의 최대값과 최소값은 지도 보기 유형(2D, 3D 또는 Streetside)에 따라 달라집니다.

속성2D 범위3D 범위스트리트 사이드 범위
ZoomLevel1-201-2024-26

Streetside 보기를 벗어나면 지도가 이전 보기 설정으로 돌아갑니다. Streetside ZoomLevel은 Streetside 환경 외부에서 유지 관리되지 않습니다.

기본 UI 컨트롤을 사용자 고유의 컨트롤로 바꾸려면 이 메서드를 고려합니다.

적용 대상