信息
您所需的主题如下所示。但此主题未包含在此库中。

ContactMapActivatedEventArgs Class

提供有关何时激活应用程序来映射联系人的数据。

JavaScript:  此类型显示为 WebUIContactMapActivatedEventArgs

语法


public sealed class ContactMapActivatedEventArgs : IContactMapActivatedEventArgs,
    IContactActivatedEventArgs,
    IActivatedEventArgs

特性

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

成员

ContactMapActivatedEventArgs类 具有这些类型的成员:

方法

The ContactMapActivatedEventArgs 类 继承这些方法于:Object 类.

属性

ContactMapActivatedEventArgs类 具有这些属性。

属性访问类型说明

Address

只读Gets the address of a contact for the mapping operation.

Contact

只读Gets the contact for the mapping operation.

Kind

只读Gets the activation type.

PreviousExecutionState

只读Gets the execution state of the app before it was activated.

SplashScreen

只读Gets the splash screen object, which provides information about the transition from the splash screen to the activated app.

Verb

只读Gets the action to be performed.

 

备注

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>


在清单中注册后,应用程序可以为联系人映射协定而激活。激活了应用时,可以使用事件信息来确定映射激活,并提取可帮助你完成用户的映射方案的参数。

示例

下面是一个处理联系人映射激活所需代码的示例:


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


要求

最低支持客户端

Windows 8.1 [仅 Windows 应用商店应用程序]

最低支持服务器

Windows Server 2012 R2 [仅 Windows 应用商店应用程序]

命名空间

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

元数据

Windows.winmd

另请参见

Object
IContactMapActivatedEventArgs
IContactActivatedEventArgs
IActivatedEventArgs
处理联系人操作示例

 

 

显示: