ContactMapActivatedEventArgs-Klasse

ContactMapActivatedEventArgs Class

Stellt Daten bereit, wenn eine Anwendung aktiviert wird, um einen Kontakt zuzuordnen.

JavaScript:  Dieser Typ wird als WebUIContactMapActivatedEventArgs angezeigt.

Syntax


public sealed class ContactMapActivatedEventArgs : IContactMapActivatedEventArgs,
    IContactActivatedEventArgs,
    IActivatedEventArgs

Attribute

[MarshalingBehavior(Agile)]
[Version(0x06030000)]

Member

ContactMapActivatedEventArgsKlasse hat diese Membertypen:

Methoden

The ContactMapActivatedEventArgs Klasse erbt Methoden von Object Klasse.

Eigenschaften

Der ContactMapActivatedEventArgsKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

Address

SchreibgeschütztGets the address of a contact for the mapping operation.

Contact

SchreibgeschütztGets the contact for the mapping operation.

Kind

SchreibgeschütztGets the activation type.

PreviousExecutionState

SchreibgeschütztGets the execution state of the app before it was activated.

SplashScreen

SchreibgeschütztGets the splash screen object, which provides information about the transition from the splash screen to the activated app.

Verb

SchreibgeschütztGets the action to be performed.

 

Hinweise

Unter Windows 8.1 können Benutzer die Standorte ihrer Kontakte auf der Visitenkarte oder der Windows Search-Benutzeroberfläche zuordnen. Durch das Implementieren des Vertrags zur Aktivierung von Kontaktzuordnung kann Windows die App starten, um für den Benutzer Standorte zuzuordnen.

Um Zuordnungsaktivierungen zu empfangen, muss die App für die Erweiterungskategorie "windows.contact" im Manifest registriert werden. Unter dieser Erweiterung müssen Sie ein "LaunchAction"-Element mit dem "Verb"-Attribut einschließen, das "map" entspricht.

Wenn mehrere Apps für den Vertrag registriert wurden, kann der Benutzer eine davon als Standard für die Verwaltung der Zuordnung auswählen.

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>


Nach der Registrierung im Manifest kann die App für den Vertrag für die Kontaktzuordnung aktiviert werden. Wenn Ihre App aktiviert ist, können Sie mit den Ereignisinformationen die Zuordnungsaktivierung identifizieren und die Parameter extrahieren, mit denen Sie das Zuordnungsszenario für den Benutzer abschließen können.

Beispiele

Im Folgenden ein Beispiel des Codes, den Sie benötigen, um Kontaktzuordnungsaktivierungen zu behandeln:


protected override void OnActivated(IActivatedEventArgs args)
{
    if (args.Kind == ActivationKind.Contact)
    {
        var contactArgs = args as IContactActivatedEventArgs;
        if (contactArgs.Verb == Windows.ApplicationModel.Contacts.ContactLaunchActionVerbs.Map)
        { 
            IContactMapActivatedEventArgs mapArgs = contactArgs as IContactMapActivatedEventArgs;

     //get contact display info
     var contactName = mapArgs.Contact.DisplayName;
            var contactThumbnail = mapArgs.Contact.Thumbnail;

            var address = mapArgs.address;
            //add mapping logic
        }
                
    }
}


Anforderungen

Mindestens unterstützter Client

Windows 8.1 [Nur Windows Store-Apps]

Mindestens unterstützter Server

Windows Server 2012 R2 [Nur Windows Store-Apps]

Namespace

Windows.ApplicationModel.Activation
Windows::ApplicationModel::Activation [C++]

Metadaten

Windows.winmd

Siehe auch

Object
IContactMapActivatedEventArgs
IContactActivatedEventArgs
IActivatedEventArgs
Beispiel für die Behandlung von Kontaktaktionen

 

 

Anzeigen:
© 2017 Microsoft