WebUIContactPostActivatedEventArgs Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.WebUI
Modifica

Fornisce i dati quando un'app viene attivata per pubblicare un contatto.

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
Ereditarietà
Object Platform::Object IInspectable WebUIContactPostActivatedEventArgs
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute
Implementazioni
IActivatedEventArgs IContactActivatedEventArgs IContactPostActivatedEventArgs IActivatedEventArgsDeferral

Requisiti Windows

Famiglia di dispositivi
Windows Desktop Extension SDK (è stato introdotto in 10.0.10240.0)
API contract
Windows.ApplicationModel.Activation.ContactActivatedEventsContract (è stato introdotto in v1.0)

Esempio

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

Commenti

Questo oggetto viene accessibile quando si implementa un gestore eventi per WinJS.Application.Onactivated o Windows.UI.WebUI.WebUI.WebUIApplication.trigger quando ActivationKind è contatto.

Nota

Questa classe non è agile, il che significa che è necessario considerare il relativo modello di threading e il comportamento di marshalling. Per altre informazioni, vedere Threading e marshalling (C++/CX).

Windows 8.1 consente agli utenti di pubblicare i contatti dall'esperienza Contact Card o Windows Search. Implementando il contratto di attivazione del contatto, Windows può avviare l'app per pubblicare per l'utente.

Per ricevere attivazioni successive, l'app deve registrarsi per la categoria di estensione "windows.contact" nel relativo manifesto. In questa estensione è necessario includere un elemento "LaunchAction" con l'attributo "Verb" uguale a "post". È quindi possibile specificare l'elemento "ServiceId" per specificare il nome di dominio del servizio a cui è possibile inviare l'app, ad esempio "facebook.com".

Se più app sono state registrate per questo contratto, l'utente può sceglierne uno come impostazione predefinita per la gestione della registrazione.

Ecco un esempio per la registrazione del 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>

Dopo aver registrato il manifesto, l'app può essere attivata per il contratto di post contatto. Quando l'app viene attivata, è possibile usare le informazioni sull'evento per identificare l'attivazione successiva ed estrarre i parametri che consentono di completare lo scenario post per l'utente.

Ecco un esempio del codice che è necessario gestire le attivazioni dei post di contatto per Gli ID Facebook:

Proprietà

ActivatedOperation

Ottiene l'operazione attivata dall'app.
Contact

Ottiene il contatto per il post.
Kind

Ottiene il tipo di attivazione.
PreviousExecutionState

Ottiene lo stato di esecuzione dell'app prima dell'attivazione.
ServiceId

Ottiene l'identificatore del servizio usato per il post.
ServiceUserId

Ottiene l'identificatore utente del servizio usato per il post.
SplashScreen

Ottiene l'oggetto schermata iniziale, che fornisce informazioni sulla transizione dalla schermata iniziale all'app attivata.
Verb

Ottiene l'azione da eseguire.

Si applica a

Vedi anche