Freigeben über


WebUIContactMessageActivatedEventArgs Klasse

Definition

Stellt Daten bereit, wenn eine App aktiviert wird, um einem Kontakt eine Nachricht zu senden.

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
Vererbung
Object Platform::Object IInspectable WebUIContactMessageActivatedEventArgs
Attribute
Implementiert

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

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, ihren Kontakten eine Nachricht über die Visitenkarte oder Windows Search-Benutzeroberfläche zu senden. Durch die Implementierung des Vertrags zur Aktivierung von Kontaktnachrichten kann Windows Ihre App starten, um Nachrichten für den Benutzer zu senden.

Um Nachrichtenaktivierungen zu empfangen, 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 "message" ist. Anschließend können Sie das "ServiceId"-Element angeben, um den Typ des von Ihnen unterstützten Messagings anzugeben. Wenn Ihre App beispielsweise Standard-Textnachrichten verarbeitet, können Sie eine "ServiceId" von "Telefon" angeben. Wenn Ihre App Messaging über einen webbasierten Dienst wie Skype verarbeitet, können Sie den Domänennamen dieses Diensts angeben, z. B. "skype.com".

Wenn mehrere Apps für diesen Vertrag registriert wurden, kann der Benutzer eine davon als Standard für die Verarbeitung von Nachrichten 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="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>

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

Hier sehen Sie ein Beispiel für den Code, den Sie für die Aktivierung von Kontaktnachrichten für PSTN-Nummern und Skype-IDs benötigen:

Eigenschaften

ActivatedOperation

Ruft den app-aktivierten Vorgang ab.

Contact

Ruft den Kontakt für die Nachricht 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 die Nachricht verwendet wird.

ServiceUserId

Ruft den Benutzerbezeichner des Diensts ab, der für die Nachricht 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