WebUIContactPostActivatedEventArgs Classe

  • Référence

Définition

Espace de noms:
Windows.UI.WebUI
Modifier

Fournit des données lorsqu’une application est activée pour publier un contact.

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
Héritage
Object Platform::Object IInspectable WebUIContactPostActivatedEventArgs
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute
Implémente
IActivatedEventArgs IContactActivatedEventArgs IContactPostActivatedEventArgs IActivatedEventArgsDeferral

Configuration requise pour Windows

Famille d’appareils
Windows Desktop Extension SDK (introduit dans 10.0.10240.0)
API contract
Windows.ApplicationModel.Activation.ContactActivatedEventsContract (introduit dans v1.0)

Exemples

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

Remarques

Cet objet est accessible lorsque vous implémentez un gestionnaire d’événements pour les événements WinJS.Application.Onactivated ou Windows.UI.WebUI.WebUIApplication.activated lorsque ActivationKind est en contact.

Notes

Cette classe n’est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d’informations, consultez Threading and Marshaling (C++/CX).

Windows 8.1 permet aux utilisateurs de publier sur leurs contacts à partir de l’expérience Carte de visite ou Recherche Windows. En implémentant le contrat de post-activation du contact, Windows peut lancer votre application pour publier pour l’utilisateur.

Pour recevoir des activations postérieures, votre application doit s’inscrire à la catégorie d’extension « windows.contact » dans son manifeste. Sous cette extension, vous devez inclure un élément « LaunchAction » avec l’attribut « Verb » égal à « post ». Vous pouvez ensuite spécifier l’élément « ServiceId » pour spécifier le nom de domaine du service dans lequel votre application peut publier, par exemple « facebook.com ».

Si plusieurs applications se sont inscrites pour ce contrat, l’utilisateur peut choisir l’une d’elles par défaut pour la gestion de la publication.

Voici un exemple d’inscription de manifeste :

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

Une fois que vous vous êtes inscrit dans votre manifeste, votre application peut être activée pour le contrat post-contact. Lorsque votre application est activée, vous pouvez utiliser les informations d’événement pour identifier la post-activation et extraire les paramètres qui vous aident à effectuer le scénario de publication pour l’utilisateur.

Voici un exemple de code dont vous avez besoin pour gérer les activations de post-contact pour les ID Facebook :

Propriétés

ActivatedOperation

Obtient l’opération activée par l’application.
Contact

Obtient le contact pour la publication.
Kind

Obtient le type d’activation.
PreviousExecutionState

Obtient l’état d’exécution de l’application avant son activation.
ServiceId

Obtient l’identificateur du service utilisé pour la publication.
ServiceUserId

Obtient l’identificateur utilisateur du service utilisé pour la publication.
SplashScreen

Obtient l’objet d’écran de démarrage, qui fournit des informations sur la transition de l’écran de démarrage vers l’application activée.
Verb

Obtient l’action à effectuer.

S’applique à

Voir aussi