Share via


WebUIContactMapActivatedEventArgs Kelas

Definisi

Menyediakan data saat aplikasi diaktifkan untuk memetakan kontak.

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
Warisan
Object Platform::Object IInspectable WebUIContactMapActivatedEventArgs
Atribut
Penerapan

Persyaratan Windows

Rangkaian perangkat
Windows Desktop Extension SDK (diperkenalkan dalam 10.0.10240.0)
API contract
Windows.ApplicationModel.Activation.ContactActivatedEventsContract (diperkenalkan dalam v1.0)

Contoh

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

Keterangan

Objek ini diakses ketika Anda menerapkan penanganan aktivitas untuk peristiwa WinJS.Application.Onactivated atau Windows.UI.WebUI.WebUIApplication.activated ketika ActivationKindadalah kontak.

Catatan

Kelas ini tidak tangkas, yang berarti Anda perlu mempertimbangkan model utas dan perilaku marshalingnya. Untuk informasi selengkapnya, lihat Threading dan Marshaling (C++/CX).

Windows 8.1 memungkinkan pengguna untuk memetakan lokasi kontak mereka dari pengalaman Kartu Kontak atau Pencarian Windows. Dengan menerapkan kontrak aktivasi peta kontak, Windows dapat meluncurkan aplikasi Anda ke lokasi peta untuk pengguna.

Untuk menerima aktivasi peta, aplikasi Anda harus mendaftar untuk kategori ekstensi "windows.contact" dalam manifesnya. Di bawah ekstensi ini, Anda harus menyertakan elemen "LaunchAction" dengan atribut "Kata Kerja" yang sama dengan "peta."

Jika beberapa aplikasi telah mendaftar untuk kontrak ini, pengguna dapat memilih salah satunya sebagai default mereka untuk menangani pemetaan.

Berikut adalah contoh untuk pendaftaran manifes:

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

Setelah mendaftar dalam manifes, aplikasi Anda dapat diaktifkan untuk kontrak peta kontak. Saat aplikasi diaktifkan, Anda dapat menggunakan informasi peristiwa untuk mengidentifikasi aktivasi peta dan mengekstrak parameter yang membantu Anda menyelesaikan skenario pemetaan untuk pengguna.

Berikut adalah contoh kode yang Anda butuhkan untuk menangani aktivasi peta kontak:

Properti

ActivatedOperation

Mendapatkan operasi yang diaktifkan aplikasi.

Address

Mendapatkan alamat kontak untuk operasi pemetaan.

Contact

Mendapatkan kontak untuk operasi pemetaan.

Kind

Mendapatkan jenis aktivasi.

PreviousExecutionState

Mendapatkan status eksekusi aplikasi sebelum diaktifkan.

SplashScreen

Mendapatkan objek layar splash, yang menyediakan informasi tentang transisi dari layar splash ke aplikasi yang diaktifkan.

Verb

Mendapatkan tindakan yang akan dilakukan.

Berlaku untuk

Lihat juga