Freigeben über

WebUIContactPostActivatedEventArgs Klasse

  • Referenz

Definition

Namespace:
Windows.UI.WebUI
Bearbeiten

Stellt Daten bereit, wenn eine App zum Posten eines Kontakts aktiviert wird.

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
Vererbung
Object Platform::Object IInspectable WebUIContactPostActivatedEventArgs
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute
Implementiert
IActivatedEventArgs IContactActivatedEventArgs IContactPostActivatedEventArgs IActivatedEventArgsDeferral

Windows-Anforderungen

Gerätefamilie
Windows Desktop Extension SDK (eingeführt in 10.0.10240.0)
API contract
Windows.ApplicationModel.Activation.ContactActivatedEventsContract (eingeführt in v1.0)

Beispiele

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

Hinweise

Auf dieses Objekt wird zugegriffen, wenn Sie einen Ereignishandler für die Ereignisse WinJS.Application.Onactivated oder Windows.UI.WebUI.WebUIApplication.activated implementieren, wenn ActivationKindkontaktiert wird.

Hinweis

Diese Klasse ist nicht agil, was bedeutet, dass Sie das Threadingmodell und das Marshallingverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading und Marshalling (C++/CX).

Windows 8.1 ermöglicht Es Benutzern, über die Benutzeroberfläche Visitenkarte oder Windows Search beiträge in ihren Kontakten zu posten. Durch die Implementierung des Vertrags für Kontakt nach der Aktivierung kann Windows Ihre App starten, um für den Benutzer beiträgen zu können.

Um Postaktivierungen zu erhalten, muss sich Ihre App für die Erweiterungskategorie "windows.contact" in ihrem Manifest registrieren. Unter dieser Erweiterung müssen Sie ein "LaunchAction"-Element mit dem Attribut "Verb" einschließen, das gleich "post" ist. Anschließend können Sie das "ServiceId"-Element angeben, um den Domänennamen des Diensts anzugeben, an den Ihre App posten kann, z. B. "facebook.com".

Wenn mehrere Apps für diesen Vertrag registriert wurden, kann der Benutzer eine davon als Standard für die Bearbeitung der Veröffentlichung auswählen.

Hier sehen Sie ein Beispiel für die Manifestregistrierung:

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

Nachdem Sie sich in Ihrem Manifest registriert haben, kann Ihre App für den Kontakt nach dem Vertrag aktiviert werden. Wenn Ihre App aktiviert ist, können Sie die Ereignisinformationen verwenden, um die Nachaktivierung zu identifizieren und die Parameter zu extrahieren, mit denen Sie das Postszenario für den Benutzer abschließen können.

Hier sehen Sie ein Beispiel für den Code, den Sie zum Verarbeiten von Kontakt-Post-Aktivierungen für Facebook-IDs benötigen:

Eigenschaften

ActivatedOperation

Ruft den app-aktivierten Vorgang ab.
Contact

Ruft den Kontakt für den Beitrag ab.
Kind

Ruft den Aktivierungstyp ab.
PreviousExecutionState

Ruft den Ausführungsstatus der App ab, bevor sie aktiviert wurde.
ServiceId

Ruft den Bezeichner des Diensts ab, der für den Beitrag verwendet wird.
ServiceUserId

Ruft den Benutzerbezeichner des Diensts ab, der für den Beitrag verwendet wird.
SplashScreen

Ruft das Begrüßungsbildschirmobjekt ab, das Informationen zum Übergang vom Begrüßungsbildschirm zur aktivierten App bereitstellt.
Verb

Ruft die auszuführende Aktion ab.

Gilt für:

Weitere Informationen