ContactMapActivatedEventArgs Classe

Definizione

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

Ereditarietà

Object Platform::Object IInspectable ContactMapActivatedEventArgs

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Implementazioni

IActivatedEventArgs IContactActivatedEventArgs IContactMapActivatedEventArgs

Requisiti Windows

Esempio

Ecco un esempio del codice necessario per gestire le attivazioni della mappa dei contatti.

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

Commenti

Windows 8.1 consente agli utenti di eseguire il mapping delle posizioni dei contatti dall'esperienza Contact Card o Windows Search. Implementando il contratto di attivazione della mappa dei contatti, Windows può avviare l'app per eseguire il mapping delle posizioni per l'utente.

Per ricevere attivazioni mappa, l'app deve registrarsi per la categoria di estensione "windows.contact" nel relativo manifesto. In questa estensione è necessario includere un elemento "LaunchAction" con l'attributo "Verb" uguale a "map".

Se più app sono state registrate per questo contratto, l'utente può sceglierne uno come impostazione predefinita per la gestione del mapping.

Ecco un esempio per la registrazione del manifesto.

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

Dopo aver registrato il manifesto, l'app può essere attivata per il contratto della mappa dei contatti. Quando l'app viene attivata, è possibile usare le informazioni sull'evento per identificare l'attivazione della mappa ed estrarre i parametri che consentono di completare lo scenario di mapping per l'utente.

Per informazioni su come gestire l'attivazione dell'app tramite azioni di contatto, vedere Avvio rapido: Gestione delle azioni di contatto .

Proprietà

Si applica a

Vedi anche

• IContactMapActivatedEventArgs
• IContactActivatedEventArgs
• IActivatedEventArgs
• Esempio di gestione delle azioni sui contatti