ContactMapActivatedEventArgs 클래스

정의

네임스페이스:

Windows.ApplicationModel.Activation

연락처를 매핑하기 위해 앱이 활성화될 때 데이터를 제공합니다.

자바 스크립트 이 형식은 WebUIContactMapActivatedEventArgs로 표시됩니다.

public ref class ContactMapActivatedEventArgs sealed : IActivatedEventArgs, IContactMapActivatedEventArgs

/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Activation.ContactActivatedEventsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ContactMapActivatedEventArgs final : IActivatedEventArgs, IContactMapActivatedEventArgs

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Activation.ContactActivatedEventsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ContactMapActivatedEventArgs : IActivatedEventArgs, IContactMapActivatedEventArgs

Public NotInheritable Class ContactMapActivatedEventArgs
Implements IActivatedEventArgs, IContactMapActivatedEventArgs

상속

Object Platform::Object IInspectable ContactMapActivatedEventArgs

특성

ContractVersionAttribute MarshalingBehaviorAttribute

구현

IActivatedEventArgs IContactActivatedEventArgs IContactMapActivatedEventArgs

Windows 요구 사항

디바이스 패밀리	Windows Desktop Extension SDK (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.ApplicationModel.Activation.ContactActivatedEventsContract (v1.0에서 도입되었습니다.)

예제

연락처 맵 활성화를 처리하는 데 필요한 코드의 예는 다음과 같습니다.

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
        }
    }
}

void App::OnActivated(Windows::ApplicationModel::Activation::IActivatedEventArgs const& args)
{
    if (args.Kind() == Windows::ApplicationModel::Activation::ActivationKind::Contact)
    {
        auto contactArgs{ args.as<Windows::ApplicationModel::Activation::IContactActivatedEventArgs>() };
        if (contactArgs.Verb() == Windows::ApplicationModel::Contacts::ContactLaunchActionVerbs::Map())
        {
            auto mapArgs{ contactArgs.as<Windows::ApplicationModel::Activation::ContactMapActivatedEventArgs>() };

            // Get contact display info.
            auto contactName{ mapArgs.Contact().DisplayName() };
            auto contactThumbnail{ mapArgs.Contact().Thumbnail() };

            auto address{ mapArgs.Address() };
            // Add mapping logic.
        }
    }
}

void App::OnActivated(IActivatedEventArgs^ args)
{
    if (args->Kind == ActivationKind::Contact)
    {
        auto contactArgs = dynamic_cast<IContactActivatedEventArgs^>(args);
        if (contactArgs->Verb == Windows::ApplicationModel::Contacts::ContactLaunchActionVerbs::Map)
        {
            auto mapArgs = dynamic_cast<ContactMapActivatedEventArgs^>(contactArgs);

            //get contact display info
            auto contactName = mapArgs->Contact->DisplayName;
            auto contactThumbnail = mapArgs->Contact->Thumbnail;

            auto address = mapArgs->address;
            //add mapping logic
        }
    }
}

설명

Windows 8.1 통해 사용자는 연락처 카드 또는 Windows Search 환경에서 연락처의 위치를 매핑할 수 있습니다. 연락처 맵 활성화 계약을 구현하면 Windows에서 앱을 시작하여 사용자의 위치를 매핑할 수 있습니다.

맵 활성화를 받으려면 앱이 매니페스트에서 "windows.contact" 확장 범주에 등록해야 합니다. 이 확장에서 "Verb" 특성이 "map"과 같은 "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>

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

연락처 작업을 통해 앱 활성화를 처리하는 방법에 대한 자세한 내용은 빠른 시작: 연락처 작업 처리를 참조하세요 .

속성

Address	매핑 작업의 연락처 주소를 가져옵니다.
Contact	매핑 작업의 연락처를 가져옵니다.
Kind	활성화 유형을 가져옵니다.
PreviousExecutionState	활성화되기 전에 앱의 실행 상태를 가져옵니다.
SplashScreen	시작 화면에서 활성화된 앱으로의 전환에 대한 정보를 제공하는 시작 화면 개체를 가져옵니다.
Verb	수행할 작업을 가져옵니다.

추가 정보

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