Come acconsentire esplicitamente all'invio di notifiche di tipo avviso popup (app di Windows Runtime)

  • Articolo

[ Questo articolo è rivolto agli sviluppatori per Windows 8.x e Windows Phone 8.x che realizzano app di Windows Runtime. Gli sviluppatori che usano Windows 10 possono vedere Documentazione aggiornata ]

Nota  Se non usi JavaScript, vedi Come accettare esplicitamente le notifiche di tipo avviso popup (XAML).

 

In questo argomento viene illustrato come specificare che l'app è in grado di generare notifiche di tipo avviso popup.

Cosa sapere

Tecnologie

  • Windows Runtime

Prerequisiti

Per comprendere questo argomento, devi disporre di:

  • Conoscenza operativa di termini e concetti correlati alle notifiche di tipo avviso popup. Per altre informazioni, vedi Panoramica degli avvisi popup.
  • Familiarità con lo schema XML degli avvisi popup e con XML e le relative tecniche di modifica attraverso le API Document Object Model (DOM). Per altre informazioni, vedi Schema degli avvisi popup.

Istruzioni

Passaggio 1: Dichiarare la funzionalità di notifica di tipo avviso popup

La capacità di generare notifiche di tipo avviso popup è dichiarata nel file package.appxmanifest dell'app. Se usi l'editor del manifesto di Microsoft Visual Studio, imposta semplicemente l'opzione Popup supportati su "Sì" nella sezione Notifiche della scheda Applicazione.

L'esempio seguente mostra l'XML incluso nel file package.appxmanifest dopo la scelta di questa opzione. L'attributo ToastCapable viene aggiunto all'elemento VisualElements del manifesto.

Questo esempio illustra inoltre gli elementi che è necessario aggiungere per creare manualmente il file package.appxmanifest, all'esterno di Visual Studio. Per altre informazioni, vedi Come creare manualmente un manifesto del pacchetto. Tieni presente che mentre l'opzione in Visual Studio è "Sì", nel file package.appxmanifest viene in effetti scritto "true".


<VisualElements 
    ...
    ToastCapable="true">
</VisualElements>

Passaggio 2: Dichiarare un colore di sfondo e del testo per le notifiche di tipo avviso popup (solo Windows)

Puoi dichiarare un colore di sfondo e un tipo di testo chiaro o scuro per le notifiche di tipo avviso popup. Tieni presente che questa impostazione si applica inoltre ai riquadri — i colori di sfondo e del testo di notifiche di tipo riquadro e avviso popup sono sempre collegati..

Se usi l'editor del manifesto di Visual Studio, seleziona l'opzione Testo in primo piano nella scheda Asset visivi. Imposta l'opzione Colore di sfondo specificando una stringa di colore in formato W3DC, ad esempio "#FFFFFF".

Nota  Le app di Windows Phone Store non consentono di impostare un colore per il testo o lo sfondo. Il colore di sfondo è quello principale di sistema, che l'utente può scegliere in Impostazioni, mentre il testo è sempre "light".

L'esempio seguente mostra l'XML incluso nel file package.appxmanifest come risultato delle opzioni scelte. Gli attributi ForegroundText e BackgroundColor vengono aggiunti all'elemento VisualElements del manifesto.


<VisualElements 
    ...
    ForegroundText="dark" 
    BackgroundColor="#FFFFFF">
</VisualElements>

L'immagine di logo piccolo dell'app viene visualizzata nell'angolo inferiore destro di ogni notifica di tipo avviso popup, per indicare all'utente l'app che l'ha generato.

Nota  Windows Phone 8.1 non fa uso di questa immagine del logo. Il riquadro mostra solo il nome visualizzato dell'app (dichiarato nel manifesto) o nulla.

Se usi l'editor del manifesto di Visual Studio, imposta il percorso dell'immagine Logo quadrato 30x30 (Windows) o Logo quadrato 44x44 (Windows Phone) nella scheda Asset visivi. L'immagine specificata deve essere inclusa nel pacchetto dell'app.

L'esempio seguente mostra l'XML incluso nel file package.appxmanifest come risultato delle opzioni scelte. L'attributo SmallLogo viene aggiunto all'elemento VisualElements del manifesto.


<VisualElements 
    ...
    SmallLogo="images\smallTile-sdk.png">
</VisualElements>

Osservazioni

Dopo aver completato questi passaggi, l'app può inviare notifiche di tipo avviso popup all'utente

Esempio completo

L'esempio seguente illustra il codice XML completo per un elemento VisualElements di un'app di Windows di esempio nel file package.appxmanifest, con gli attributi presentati in questo argomento.


<VisualElements 
    DisplayName="ToastsSample" 
    Logo="images\squareTile-sdk.png" 
    SmallLogo="images\smallTile-sdk.png" 
    Description="SDK Sample" 
    ForegroundText="dark" 
    BackgroundColor="#FFFFFF" 
    ToastCapable="true">
    <DefaultTile ShortName="ToastsSample" ShowName="allLogos"/>
    <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png"/>
</VisualElements>

Argomenti correlati

Panoramica delle notifiche di tipo avviso popup

Linee guida ed elenco di controllo per le notifiche di tipo avviso popup

Esempio di notifiche di tipo avviso popup