WebUIContactMapActivatedEventArgs 類別

定義

命名空間:

Windows.UI.WebUI

在啟動應用程式以對應連絡人時提供資料。

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

繼承

Object Platform::Object IInspectable WebUIContactMapActivatedEventArgs

屬性

ContractVersionAttribute MarshalingBehaviorAttribute

實作

IActivatedEventArgs IContactActivatedEventArgs IContactMapActivatedEventArgs IActivatedEventArgsDeferral

Windows 需求

裝置系列	Windows Desktop Extension SDK (已於 10.0.10240.0 引進)
API contract	Windows.ApplicationModel.Activation.ContactActivatedEventsContract (已於 v1.0 引進)

範例

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

備註

當您在ContactActivationKind時實作WinJS.Application.Onactivated或Windows.UI.WebUI.WebUIApplication.activated事件的事件處理常式時，就會存取此物件。

注意

這個類別不是敏捷的，這表示您必須考慮其執行緒模型和封送處理行為。 如需詳細資訊，請參閱 執行緒和封送處理 (C++/CX) 。

Windows 8.1可讓使用者從連絡人卡片或 Windows 搜尋體驗對應其連絡人的位置。 藉由實作連絡人地圖啟用合約，Windows 可以啟動您的應用程式來對應使用者的位置。

若要接收地圖啟用，您的應用程式必須在其資訊清單中註冊 「windows.contact」 延伸模組類別。 在此延伸底下，您必須包含 「LaunchAction」 元素，且 「Verb」 屬性等於 「map」。

如果有多個應用程式已註冊此合約，使用者可以選擇其中一個應用程式作為處理對應的預設值。

以下是資訊清單註冊的範例：

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

在資訊清單中註冊之後，即可針對連絡人對應合約啟用您的應用程式。 當您的應用程式啟用時，您可以使用事件資訊來識別地圖啟用，並擷取參數，以協助您完成使用者的對應案例。

以下是您需要處理連絡人對應啟用的程式碼範例：

屬性

ActivatedOperation	取得應用程式啟動的作業。
Address	取得對應作業的連絡人位址。
Contact	取得對應作業的連絡人。
Kind	取得啟用類型。
PreviousExecutionState	取得應用程式啟動前的執行狀態。
SplashScreen	取得啟動顯示畫面物件，該物件提供從啟動顯示畫面轉換到啟動應用程式的相關資訊。
Verb	取得要執行的動作。

另請參閱

• IContactMapActivatedEventArgs
• IContactActivatedEventArgs
• IActivatedEventArgs
• IActivatedEventArgsDeferral
• 處理連絡人動作範例