WebUIContactMessageActivatedEventArgs Classe

Definição

public ref class WebUIContactMessageActivatedEventArgs sealed : IActivatedEventArgs, IContactMessageActivatedEventArgs, IActivatedEventArgsDeferral

/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Activation.ContactActivatedEventsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class WebUIContactMessageActivatedEventArgs final : IActivatedEventArgs, IContactMessageActivatedEventArgs, IActivatedEventArgsDeferral

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Activation.ContactActivatedEventsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class WebUIContactMessageActivatedEventArgs : IActivatedEventArgs, IContactMessageActivatedEventArgs, IActivatedEventArgsDeferral

Public NotInheritable Class WebUIContactMessageActivatedEventArgs
Implements IActivatedEventArgs, IActivatedEventArgsDeferral, IContactMessageActivatedEventArgs

Herança

Object Platform::Object IInspectable WebUIContactMessageActivatedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

IActivatedEventArgs IContactActivatedEventArgs IContactMessageActivatedEventArgs IActivatedEventArgsDeferral

Requisitos do Windows

Exemplos

JavaScript

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

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

            if (eventObject.detail.serviceId === "telephone") {
                var phoneNumber = eventObject.detail.serviceUserId;
  //add messaging logic for PSTN numbers
            }
     else if (eventObject.detail.serviceId === "skype.com") {
                var userId = eventObject.detail.serviceUserId;
  //add messaging logic for Skype Ids
            }
        }
    }
}

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.

Windows 8.1 permite que os usuários remetam mensagens de seus contatos do Cartão de Visita ou da experiência do Windows Search. Ao implementar o contrato de ativação de mensagem de contato, o Windows pode iniciar seu aplicativo para enviar mensagens para o usuário.

Para receber ativações de mensagens, 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 "message". Em seguida, você pode especificar o elemento "ServiceId" para especificar o tipo de mensagens compatível. Por exemplo, se o aplicativo manipular mensagens de texto padrão, você poderá especificar uma "ServiceId" de "telefone". Se seu aplicativo manipular mensagens em um serviço baseado na Web, como o Skype, você poderá especificar o nome de domínio desse serviço, por exemplo, "skype.com".

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

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="message" DesiredView="useLess">
        <m2:ServiceId>telephone</m2:ServiceId>
      </m2:LaunchAction>
      <m2:LaunchAction Verb="message" DesiredView="useLess">
        <m2:ServiceId>skype.com</m2:ServiceId>
      </m2:LaunchAction>
    </m2:ContactLaunchActions>
  </m2:Contact>
</m2:Extension>

Depois de se registrar em seu manifesto, seu aplicativo pode ser ativado para o contrato de mensagem de contato. Quando seu aplicativo é ativado, você pode usar as informações de evento para identificar a ativação da mensagem e extrair os parâmetros que ajudam você a concluir o cenário de mensagens para o usuário.

Aqui está um exemplo do código que você precisa para lidar com ativações de mensagens de contato para números PSTN e IDs do Skype:

Propriedades

Aplica-se a

Confira também

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