WebUIContactMapActivatedEventArgs Clase

  • Referencia

Definición

Espacio de nombres:
Windows.UI.WebUI
Editar

Proporciona datos cuando se activa una aplicación para asignar un contacto.

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
Herencia
Object Platform::Object IInspectable WebUIContactMapActivatedEventArgs
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute
Implementaciones
IActivatedEventArgs IContactActivatedEventArgs IContactMapActivatedEventArgs IActivatedEventArgsDeferral

Requisitos de Windows

Familia de dispositivos
Windows Desktop Extension SDK (se introdujo en la versión 10.0.10240.0)
API contract
Windows.ApplicationModel.Activation.ContactActivatedEventsContract (se introdujo en la versión v1.0)

Ejemplos

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

Comentarios

Se tiene acceso a este objeto cuando se implementa un controlador de eventos para los eventos WinJS.Application.Onactivated o Windows.UI.WebUI.WebUIApplication.activated cuando Se contactaActivationKind.

Nota

Esta clase no es ágil, lo que significa que debe tener en cuenta su modelo de subprocesos y el comportamiento de serialización. Para obtener más información, consulta Subprocesos y serialización (C++/CX).

Windows 8.1 permite a los usuarios asignar las ubicaciones de sus contactos desde la experiencia de tarjeta de contacto o búsqueda de Windows. Al implementar el contrato de activación de mapa de contactos, Windows puede iniciar la aplicación para asignar ubicaciones para el usuario.

Para recibir activaciones de mapa, la aplicación debe registrarse para la categoría de extensión "windows.contact" en su manifiesto. En esta extensión, debe incluir un elemento "LaunchAction" con el atributo "Verb" igual a "map".

Si varias aplicaciones se han registrado para este contrato, el usuario puede elegir una de ellas como valor predeterminado para controlar la asignación.

Este es un ejemplo de registro de manifiesto:

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

Después de registrarse en el manifiesto, la aplicación se puede activar para el contrato de mapa de contacto. Cuando se activa la aplicación, puedes usar la información del evento para identificar la activación del mapa y extraer los parámetros que te ayudarán a completar el escenario de asignación para el usuario.

Este es un ejemplo del código que necesita para controlar las activaciones de mapa de contactos:

Propiedades

ActivatedOperation

Obtiene la operación activada de la aplicación.
Address

Obtiene la dirección de un contacto para la operación de asignación.
Contact

Obtiene el contacto de la operación de asignación.
Kind

Obtiene el tipo de activación.
PreviousExecutionState

Obtiene el estado de ejecución de la aplicación antes de activarla.
SplashScreen

Obtiene el objeto de pantalla de presentación, que proporciona información sobre la transición de la pantalla de presentación a la aplicación activada.
Verb

Obtiene la acción que se va a realizar.

Se aplica a

Consulte también