ContactMapActivatedEventArgs Clase

  • Referencia

Definición

Espacio de nombres:
Windows.ApplicationModel.Activation
Editar

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

Javascript Este tipo aparece como 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
Herencia
Object Platform::Object IInspectable ContactMapActivatedEventArgs
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute
Implementaciones
IActivatedEventArgs IContactActivatedEventArgs IContactMapActivatedEventArgs

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

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

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

Comentarios

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 para el registro de manifiestos.

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

Para obtener información sobre cómo controlar la activación de aplicaciones a través de acciones de contacto, consulte Inicio rápido: Control de acciones de contacto .

Propiedades

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