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

注解

当你为 WinJS.Application.Onactivated 或 Windows.UI.WebUI.WebUIApplication.activated 事件实现事件处理程序时，当 ActivationKind联系时，将访问此对象。

注意

此类不敏捷，这意味着需要考虑其线程模型和封送处理行为。 有关详细信息，请参阅 线程处理和封送处理 (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
• 处理联系人操作示例