WebUIContactPostActivatedEventArgs Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece dados quando um aplicativo é ativado para postar um contato.
public ref class WebUIContactPostActivatedEventArgs sealed : IActivatedEventArgs, IContactPostActivatedEventArgs, IActivatedEventArgsDeferral
/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Activation.ContactActivatedEventsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class WebUIContactPostActivatedEventArgs final : IActivatedEventArgs, IContactPostActivatedEventArgs, IActivatedEventArgsDeferral
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Activation.ContactActivatedEventsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class WebUIContactPostActivatedEventArgs : IActivatedEventArgs, IContactPostActivatedEventArgs, IActivatedEventArgsDeferral
Public NotInheritable Class WebUIContactPostActivatedEventArgs
Implements IActivatedEventArgs, IActivatedEventArgsDeferral, IContactPostActivatedEventArgs
- Herança
- 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.post) {
//get contact display info
var contactName = eventObject.detail.contact.displayName;
var contactThumbnail = eventObject.detail.contact.thumbnail;
if (eventObject.detail.serviceId === "facebook.com") {
var userId = eventObject.detail.serviceUserId;
//add posting logic for Facebook 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.
Observação
Essa classe não é ágil, o que significa que você precisa considerar seu modelo de threading e comportamento de marshaling. Para obter mais informações, consulte Threading e Marshaling (C++/CX).
Windows 8.1 permite que os usuários postem em seus contatos por meio do Cartão de Visita ou da experiência de Pesquisa do Windows. Implementando o contrato de pós-ativação de contato, o Windows pode iniciar seu aplicativo para postar para o usuário.
Para receber ativações pós-ativações, 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 "post". Em seguida, você pode especificar o elemento "ServiceId" para especificar o nome de domínio do serviço no qual seu aplicativo pode postar, por exemplo, "facebook.com".
Se vários aplicativos tiverem se registrado para esse contrato, o usuário poderá escolher um deles como padrão para lidar com a postagem.
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="post" DesiredView="useLess">
<m2:ServiceId>facebook.com</m2:ServiceId>
</m2:LaunchAction>
</m2:ContactLaunchActions>
</m2:Contact>
</m2:Extension>
Depois que você se registrar no manifesto, seu aplicativo poderá ser ativado para o contato pós-contrato. Quando seu aplicativo é ativado, você pode usar as informações de evento para identificar a pós-ativação e extrair os parâmetros que ajudam você a concluir o cenário de postagem para o usuário.
Aqui está um exemplo do código que você precisa para lidar com ativações de postagem de contato para IDs do Facebook:
Propriedades
ActivatedOperation |
Obtém a operação ativada pelo aplicativo. |
Contact |
Obtém o contato da postagem. |
Kind |
Obtém o tipo de ativação. |
PreviousExecutionState |
Obtém o estado de execução do aplicativo antes de ser ativado. |
ServiceId |
Obtém o identificador do serviço usado para a postagem. |
ServiceUserId |
Obtém o identificador de usuário do serviço usado para a postagem. |
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. |