WebUIContactMapActivatedEventArgs Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.WebUI

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Fornisce i dati quando un'app viene attivata per eseguire il mapping di un contatto.

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

Ereditarietà: Object Platform::Object IInspectable WebUIContactMapActivatedEventArgs

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute

Implementazioni: IActivatedEventArgs IContactActivatedEventArgs IContactMapActivatedEventArgs IActivatedEventArgsDeferral

Requisiti Windows

Famiglia di dispositivi	Windows Desktop Extension SDK (è stato introdotto in 10.0.10240.0)
API contract	Windows.ApplicationModel.Activation.ContactActivatedEventsContract (è stato introdotto in v1.0)

Esempio

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

Commenti

Questo oggetto è accessibile quando si implementa un gestore eventi per winJS.Application.Onactivated o gli eventi Windows.UI.WebUI.WebUIApplication.activated quando ActivationKind è contatto.

Nota

Questa classe non è agile, il che significa che è necessario considerare il modello di threading e il comportamento di marshalling. Per altre info, vedi Threading e marshalling (C++/CX).

Windows 8.1 consente agli utenti di mappare le posizioni dei contatti dall'esperienza Contatto o Windows Search. Implementando il contratto di attivazione della mappa dei contatti, Windows può avviare l'app per eseguire il mapping delle posizioni per l'utente.

Per ricevere le attivazioni della mappa, l'app deve registrarsi per la categoria di estensione "windows.contact" nel manifesto. In questa estensione è necessario includere un elemento "LaunchAction" con l'attributo "Verb" uguale a "map".

Se più app sono state registrate per questo contratto, l'utente può sceglierne uno come impostazione predefinita per la gestione del mapping.

Ecco un esempio per la registrazione del manifesto:

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

Dopo aver eseguito la registrazione nel manifesto, l'app può essere attivata per il contratto della mappa dei contatti. Quando l'app viene attivata, è possibile usare le informazioni sull'evento per identificare l'attivazione della mappa ed estrarre i parametri che consentono di completare lo scenario di mapping per l'utente.

Di seguito è riportato un esempio del codice necessario per gestire le attivazioni della mappa dei contatti:

Proprietà

ActivatedOperation	Ottiene l'operazione attivata dall'app.
Address	Ottiene l'indirizzo di un contatto per l'operazione di mapping.
Contact	Ottiene il contatto per l'operazione di mapping.
Kind	Ottiene il tipo di attivazione.
PreviousExecutionState	Ottiene lo stato di esecuzione dell'app prima dell'attivazione.
SplashScreen	Ottiene l'oggetto schermata iniziale, che fornisce informazioni sulla transizione dalla schermata iniziale all'app attivata.
Verb	Ottiene l'azione da eseguire.

Si applica a

Share via