ContactMapActivatedEventArgs Class

연락처를 매핑하기 위해 앱이 활성화되는 경우 데이터를 제공합니다.

JavaScript:  이 형식은 WebUIContactMapActivatedEventArgs로 나타납니다.

구문


public sealed class ContactMapActivatedEventArgs : IContactMapActivatedEventArgs,
    IContactActivatedEventArgs,
    IActivatedEventArgs

특성

[MarshalingBehavior(Agile)]
[Version(0x06030000)]

멤버

ContactMapActivatedEventArgs클래스에는 다음과 같은 형식의 멤버가 있습니다.

메서드

The ContactMapActivatedEventArgs 클래스 - 다음에서 메서드를 상속합니다. Object 클래스.

속성

ContactMapActivatedEventArgs클래스 - 이러한 속성이 있습니다.

속성사용 권한Description

Address

읽기 전용Gets the address of a contact for the mapping operation.

Contact

읽기 전용Gets the contact for the mapping operation.

Kind

읽기 전용Gets the activation type.

PreviousExecutionState

읽기 전용Gets the execution state of the app before it was activated.

SplashScreen

읽기 전용Gets the splash screen object, which provides information about the transition from the splash screen to the activated app.

Verb

읽기 전용Gets the action to be performed.

 

설명

Windows 8.1에서는 사용자가 연락처 카드 또는 Windows 검색 환경에서 연락처의 위치를 지도에 표시할 수 있습니다. 연락처 지도 활성화 계약을 구현할 경우 Windows는 사용자의 위치를 매핑하기 위해 앱을 실행할 수 있습니다.

맵 활성화를 받으려면 앱은 매니페스트에서 "windows.contact" 확장 범주에 등록해야 합니다. 이 확장에서 "map"과 같은 "Verb" 특성과 함께 "LaunchAction" 요소를 포함해야 합니다.

여러 앱이 이 계약에 등록한 경우 사용자는 해당 앱 중 하나를 매핑 처리를 위한 기본 앱으로 선택할 수 있습니다.

매니페스트 등록에 대한 예는 다음과 같습니다.



<m2:Extension Category="windows.contact" xmlns:m2="http://schemas.microsoft.com/appx/2013/manifest">
  <m2:Contact>
    <m2:ContactLaunchActions>
      <m2:LaunchAction Verb="map" DesiredView="useHalf"/>
    </m2:ContactLaunchActions>
  </m2:Contact>
</m2:Extension>


매니페스트에 등록한 후 연락처 지도 계약에 대해 앱을 활성화할 수 있습니다. 앱이 활성화된 경우 이벤트 정보를 사용하여 맵 활성화를 식별하고 사용자에 대해 매핑 시나리오를 완료하는 데 유용한 매개 변수를 추출할 수 있습니다.

예제

다음은 연락처 지도 활성화를 처리하는 데 필요한 코드의 예입니다.


protected override void OnActivated(IActivatedEventArgs args)
{
    if (args.Kind == ActivationKind.Contact)
    {
        var contactArgs = args as IContactActivatedEventArgs;
        if (contactArgs.Verb == Windows.ApplicationModel.Contacts.ContactLaunchActionVerbs.Map)
        { 
            IContactMapActivatedEventArgs mapArgs = contactArgs as IContactMapActivatedEventArgs;

     //get contact display info
     var contactName = mapArgs.Contact.DisplayName;
            var contactThumbnail = mapArgs.Contact.Thumbnail;

            var address = mapArgs.address;
            //add mapping logic
        }
                
    }
}


요구 사항

지원되는 최소 클라이언트

Windows 8.1 [Windows 스토어 앱만]

지원되는 최소 서버

Windows Server 2012 R2 [Windows 스토어 앱만]

Namespace

Windows.ApplicationModel.Activation
Windows::ApplicationModel::Activation [C++]

Metadata

Windows.winmd

참고 항목

Object
IContactMapActivatedEventArgs
IContactActivatedEventArgs
IActivatedEventArgs
연락처 작업 처리 샘플

 

 

표시:
© 2014 Microsoft