Partilhar via


WebUIContactMapActivatedEventArgs Classe

Definição

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

public ref class WebUIContactMapActivatedEventArgs sealed : IActivatedEventArgs, IContactMapActivatedEventArgs, IActivatedEventArgsDeferral
/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Activation.ContactActivatedEventsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class WebUIContactMapActivatedEventArgs final : IActivatedEventArgs, IContactMapActivatedEventArgs, IActivatedEventArgsDeferral
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Activation.ContactActivatedEventsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class WebUIContactMapActivatedEventArgs : IActivatedEventArgs, IContactMapActivatedEventArgs, IActivatedEventArgsDeferral
Public NotInheritable Class WebUIContactMapActivatedEventArgs
Implements IActivatedEventArgs, IActivatedEventArgsDeferral, IContactMapActivatedEventArgs
Herança
Object Platform::Object IInspectable WebUIContactMapActivatedEventArgs
Atributos
Implementações

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

JavaScript

function activated(eventObject) {
    if (eventObject.detail.kind === Windows.ApplicationModel.Activation.ActivationKind.contact) {
        if (eventObject.detail.verb === Windows.ApplicationModel.Contacts.ContactLaunchActionVerbs.map) {

     //get contact display info
            var contactName = eventObject.detail.contact.displayName;
            var contactThumbnail = eventObject.detail.contact.thumbnail;

            var address = eventObject.detail.address;
     //add mapping logic
        }
    }
}

Comentários

Esse objeto é acessado quando você implementa um manipulador de eventos para os eventos WinJS.Application.Onactivated ou Windows.UI.WebUI.WebUIApplication.activated quando ActivationKind é contatado.

Observação

Essa classe não é ágil, o que significa que você precisa considerar seu modelo de threading e o comportamento de marshaling. Para obter mais informações, consulte Threading e marshaling (C++/CX).

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.

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

Propriedades

ActivatedOperation

Obtém a operação ativada pelo aplicativo.

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.

Aplica-se a

Confira também