ContactMapActivatedEventArgs Класс

Определение

Пространство имен:

Windows.ApplicationModel.Activation

Предоставляет данные при активации приложения для сопоставления контакта.

Javascript Этот тип отображается как WebUIContactMapActivatedEventArgs.

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

Наследование

Object Platform::Object IInspectable ContactMapActivatedEventArgs

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Реализации

IActivatedEventArgs IContactActivatedEventArgs IContactMapActivatedEventArgs

Требования к Windows

Семейство устройств	Windows Desktop Extension SDK (появилось в 10.0.10240.0)
API contract	Windows.ApplicationModel.Activation.ContactActivatedEventsContract (появилось в v1.0)

Примеры

Ниже приведен пример кода, необходимого для обработки активаций карты контактов.

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

Комментарии

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>

После регистрации в манифесте приложение можно активировать для контракта карты контактов. При активации приложения можно использовать сведения о событии для идентификации активации карты и извлечения параметров, которые помогут выполнить сценарий сопоставления для пользователя.

Сведения о том, как обрабатывать активацию приложений с помощью действий контакта, см. в разделе Краткое руководство. Обработка действий контактов .

Свойства

Address	Возвращает адрес контакта для операции сопоставления.
Contact	Возвращает контакт для операции сопоставления.
Kind	Возвращает тип активации.
PreviousExecutionState	Возвращает состояние выполнения приложения до его активации.
SplashScreen	Возвращает объект экрана-заставки, предоставляющий сведения о переходе с экрана-заставки на активированное приложение.
Verb	Возвращает выполняемую операцию.

См. также раздел

• IContactMapActivatedEventArgs
• IContactActivatedEventArgs
• IActivatedEventArgs
• Пример обработки действий с контактами