WebUIContactMapActivatedEventArgs Klasse

  • Referenz

Definition

Namespace:
Windows.UI.WebUI
Bearbeiten

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

public ref class WebUIContactMapActivatedEventArgs sealed : IActivatedEventArgs, IContactMapActivatedEventArgs, IActivatedEventArgsDeferral
/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Activation.ContactActivatedEventsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class WebUIContactMapActivatedEventArgs final : IActivatedEventArgs, IContactMapActivatedEventArgs, IActivatedEventArgsDeferral
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Activation.ContactActivatedEventsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class WebUIContactMapActivatedEventArgs : IActivatedEventArgs, IContactMapActivatedEventArgs, IActivatedEventArgsDeferral
Public NotInheritable Class WebUIContactMapActivatedEventArgs
Implements IActivatedEventArgs, IActivatedEventArgsDeferral, IContactMapActivatedEventArgs
Vererbung
Object Platform::Object IInspectable WebUIContactMapActivatedEventArgs
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute
Implementiert
IActivatedEventArgs IContactActivatedEventArgs IContactMapActivatedEventArgs 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.map) {

     //get contact display info
            var contactName = eventObject.detail.contact.displayName;
            var contactThumbnail = eventObject.detail.contact.thumbnail;

            var address = eventObject.detail.address;
     //add mapping logic
        }
    }
}

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 ActivationKindKontakt ist.

Hinweis

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

Windows 8.1 ermöglicht Benutzern das Zuordnen der Standorte ihrer Kontakte über die Visitenkarten- oder Windows Search-Benutzeroberfläche. Durch Die Implementierung des Vertrags zur Aktivierung der Kontaktkarte kann Windows Ihre App starten, um Standorte für den Benutzer zuzuordnen.

Zum Empfangen von Kartenaktivierungen 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" aufnehmen, das gleich "map" ist.

Wenn mehrere Apps für diesen Vertrag registriert sind, kann der Benutzer eine von ihnen als Standard für die Verarbeitung der Zuordnung 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="map" DesiredView="useHalf"/>
    </m2:ContactLaunchActions>
  </m2:Contact>
</m2:Extension>

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

Hier sehen Sie ein Beispiel für den Code, den Sie zum Verarbeiten von Kontaktkartenaktivierungen benötigen:

Eigenschaften

ActivatedOperation

Ruft den app-aktivierten Vorgang ab.
Address

Ruft die Adresse eines Kontakts für den Zuordnungsvorgang ab.
Contact

Ruft den Kontakt für den Zuordnungsvorgang ab.
Kind

Ruft den Aktivierungstyp ab.
PreviousExecutionState

Ruft den Ausführungsstatus der App ab, bevor sie aktiviert wurde.
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