Поделиться через

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

Возвращает выполняемую операцию.

Применяется к

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