ContactMapActivatedEventArgs ContactMapActivatedEventArgs ContactMapActivatedEventArgs ContactMapActivatedEventArgs Class

Definition

public : sealed class ContactMapActivatedEventArgs : IActivatedEventArgs, IContactActivatedEventArgs, IContactMapActivatedEventArgspublic sealed class ContactMapActivatedEventArgs : IActivatedEventArgs, IContactActivatedEventArgs, IContactMapActivatedEventArgsPublic NotInheritable Class ContactMapActivatedEventArgs Implements IActivatedEventArgs, IContactActivatedEventArgs, IContactMapActivatedEventArgs// You can use this class in JavaScript.

Attributes

ContractVersionAttribute MarshalingBehaviorAttribute

Examples

Here is an example of the code you need to handle contact map activations:

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

Remarks

Windows 8.1 allows users to map their contacts' locations from the Contact Card or Windows Search experience. By implementing the contact map activation contract, Windows can launch your app to map locations for the user.

To receive map activations, your app must register for the "windows.contact" extension category in its manifest. Under this extension, you must include a "LaunchAction" element with the "Verb" attribute equal to "map."

If multiple apps have registered for this contract, the user can choose one of them as their default for handling mapping.

Here is an example for manifest registration:

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

After you register in your manifest, your app can be activated for the contact map contract. When your app is activated, you can use the event information to identify the map activation and extract the parameters that help you complete the mapping scenario for the user.

For info about how to handle app activation through contact actions, see Quickstart: Handling contact actions and Quickstart: Handling contact actions .

public : ContactAddress Address { get; }public ContactAddress Address { get; }Public ReadOnly Property Address As ContactAddress// You can use this property in JavaScript.

public : Contact Contact { get; }public Contact Contact { get; }Public ReadOnly Property Contact As Contact// You can use this property in JavaScript.

public : ActivationKind Kind { get; }public ActivationKind Kind { get; }Public ReadOnly Property Kind As ActivationKind// You can use this property in JavaScript.

public : ApplicationExecutionState PreviousExecutionState { get; }public ApplicationExecutionState PreviousExecutionState { get; }Public ReadOnly Property PreviousExecutionState As ApplicationExecutionState// You can use this property in JavaScript.

public : SplashScreen SplashScreen { get; }public SplashScreen SplashScreen { get; }Public ReadOnly Property SplashScreen As SplashScreen// You can use this property in JavaScript.

public : PlatForm::String Verb { get; }public string Verb { get; }Public ReadOnly Property Verb As string// You can use this property in JavaScript.

See Also

• Handling Contact Actions sample