ContactMapActivatedEventArgs Classe

Definição

Namespace:

Windows.ApplicationModel.Activation

Fornece dados quando um aplicativo é ativado para mapear um contato.

Javascript Esse tipo aparece como 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

Herança

Object Platform::Object IInspectable ContactMapActivatedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

IActivatedEventArgs IContactActivatedEventArgs IContactMapActivatedEventArgs

Requisitos do Windows

Família de dispositivos	Windows Desktop Extension SDK (introduzida na 10.0.10240.0)
API contract	Windows.ApplicationModel.Activation.ContactActivatedEventsContract (introduzida na v1.0)

Exemplos

Aqui está um exemplo do código que você precisa para lidar com ativações de mapa de contatos.

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

Comentários

Windows 8.1 permite que os usuários mapeiem os locais de seus contatos a partir do Cartão de Visita ou da experiência do Windows Search. Ao implementar o contrato de ativação do mapa de contatos, o Windows pode iniciar seu aplicativo para mapear locais para o usuário.

Para receber ativações de mapa, seu aplicativo deve se registrar para a categoria de extensão "windows.contact" em seu manifesto. Nessa extensão, você deve incluir um elemento "LaunchAction" com o atributo "Verbo" igual a "map".

Se vários aplicativos tiverem se registrado para esse contrato, o usuário poderá escolher um deles como padrão para lidar com o mapeamento.

Aqui está um exemplo de registro de 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>

Depois que você se registrar no manifesto, seu aplicativo poderá ser ativado para o contrato de mapa de contatos. Quando seu aplicativo é ativado, você pode usar as informações de evento para identificar a ativação do mapa e extrair os parâmetros que ajudam você a concluir o cenário de mapeamento para o usuário.

Para obter informações sobre como lidar com a ativação do aplicativo por meio de ações de contato, consulte Início Rápido: Manipulando ações de contato .

Propriedades

Address	Obtém o endereço de um contato para a operação de mapeamento.
Contact	Obtém o contato para a operação de mapeamento.
Kind	Obtém o tipo de ativação.
PreviousExecutionState	Obtém o estado de execução do aplicativo antes de ser ativado.
SplashScreen	Obtém o objeto de tela inicial, que fornece informações sobre a transição da tela inicial para o aplicativo ativado.
Verb	Obtém a ação a ser executada.

Confira também

• IContactMapActivatedEventArgs
• IContactActivatedEventArgs
• IActivatedEventArgs
• Amostra de manipulação de ações de contato