ContactMapActivatedEventArgs Klasse

Referenz

Definition

Namespace:: Windows.ApplicationModel.Activation

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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

Javascript Dieser Typ wird als WebUIContactMapActivatedEventArgs angezeigt.

public ref class ContactMapActivatedEventArgs sealed : IActivatedEventArgs, IContactMapActivatedEventArgs

/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Activation.ContactActivatedEventsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ContactMapActivatedEventArgs final : IActivatedEventArgs, IContactMapActivatedEventArgs

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Activation.ContactActivatedEventsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ContactMapActivatedEventArgs : IActivatedEventArgs, IContactMapActivatedEventArgs

Public NotInheritable Class ContactMapActivatedEventArgs
Implements IActivatedEventArgs, IContactMapActivatedEventArgs

Vererbung: Object Platform::Object IInspectable ContactMapActivatedEventArgs

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert: IActivatedEventArgs IContactActivatedEventArgs IContactMapActivatedEventArgs

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

Im Folgenden finden Sie ein Beispiel für den Code, den Sie zum Verarbeiten von Kontaktzuordnungsaktivierungen benötigen.

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

void App::OnActivated(Windows::ApplicationModel::Activation::IActivatedEventArgs const& args)
{
    if (args.Kind() == Windows::ApplicationModel::Activation::ActivationKind::Contact)
    {
        auto contactArgs{ args.as<Windows::ApplicationModel::Activation::IContactActivatedEventArgs>() };
        if (contactArgs.Verb() == Windows::ApplicationModel::Contacts::ContactLaunchActionVerbs::Map())
        {
            auto mapArgs{ contactArgs.as<Windows::ApplicationModel::Activation::ContactMapActivatedEventArgs>() };

            // Get contact display info.
            auto contactName{ mapArgs.Contact().DisplayName() };
            auto contactThumbnail{ mapArgs.Contact().Thumbnail() };

            auto address{ mapArgs.Address() };
            // Add mapping logic.
        }
    }
}

void App::OnActivated(IActivatedEventArgs^ args)
{
    if (args->Kind == ActivationKind::Contact)
    {
        auto contactArgs = dynamic_cast<IContactActivatedEventArgs^>(args);
        if (contactArgs->Verb == Windows::ApplicationModel::Contacts::ContactLaunchActionVerbs::Map)
        {
            auto mapArgs = dynamic_cast<ContactMapActivatedEventArgs^>(contactArgs);

            //get contact display info
            auto contactName = mapArgs->Contact->DisplayName;
            auto contactThumbnail = mapArgs->Contact->Thumbnail;

            auto address = mapArgs->address;
            //add mapping logic
        }
    }
}

Hinweise

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

Um Kartenaktivierungen 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 "map" ist.

Wenn mehrere Apps für diesen Vertrag registriert wurden, kann der Benutzer eine dieser Apps 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 zur Kontaktzuordnung 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.

Informationen zum Behandeln der App-Aktivierung über Kontaktaktionen finden Sie unter Schnellstart: Behandeln von Kontaktaktionen .

Eigenschaften

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:

Freigeben über