Linee guida per i riquadri secondari

Nota

I riquadri vive sono una funzionalità di Windows 10 non supportata nelle versioni successive di Windows. Per le nuove app, è consigliabile seguire le indicazioni correnti per le icone dell'app.

Un riquadro secondario offre agli utenti un modo coerente ed efficiente per accedere direttamente a aree specifiche all'interno di un'app dal menu Start. Anche se un utente sceglie se aggiungere o meno un riquadro secondario alla menu Start, le aree aggiungibili in un'app sono determinate dallo sviluppatore. Per un riepilogo più dettagliato, vedere Panoramica dei riquadri secondari. Prendi in considerazione queste linee guida quando abiliti i riquadri secondari e progetti l'interfaccia utente associata nell'app.

Nota

Solo gli utenti possono aggiungere un riquadro secondario alla menu Start; le app non possono aggiungere riquadri secondari a livello di codice. Gli utenti controllano anche la rimozione dei riquadri e possono rimuovere un riquadro secondario dal menu Start o dall'interno dell'app padre.

Consigli

Quando abiliti riquadri secondari nell'app, prendi in considerazione i suggerimenti seguenti:

  • Quando il contenuto con stato attivo è bloccabile, la barra dell'app deve contenere un pulsante "Aggiungi a Start" per creare un riquadro secondario per l'utente.
  • Quando l'utente fa clic su "Aggiungi a Start", devi chiamare immediatamente l'API dal thread dell'interfaccia utente per aggiungere il riquadro secondario.
  • Se il contenuto con stato attivo è già stato aggiunto, sostituire il pulsante "Aggiungi a Start" sulla barra dell'app con un pulsante "Rimuovi da Start". Il pulsante "Rimuovi da Start" deve rimuovere il riquadro secondario esistente.
  • Quando il contenuto dello stato attivo non è bloccabile, non visualizzare un pulsante "Aggiungi a Start" (o mostrare un pulsante "Aggiungi alla schermata Start" disabilitato).
  • Usa i glifi forniti dal sistema per i pulsanti "Aggiungi a Start" e "Rimuovi da Start" (vedi i membri aggiungi e rimuovi i membri in Windows.UI.Xaml.Controls.Symbol o WinJS.UI.AppBarIcon).
  • Usa il testo standard del pulsante: "Aggiungi a Start" e "Rimuovi da Start". Dovrai eseguire l'override del testo predefinito quando usi il pin fornito dal sistema e rimuovi i glifi.
  • Non usare un riquadro secondario come pulsante di comando virtuale per interagire con l'app padre, ad esempio un riquadro "vai alla traccia successiva".

Materiale sussidiario sull'utilizzo aggiuntivo per sviluppatori

  • Quando un'app viene avviata, deve sempre enumerare i riquadri secondari, nel caso in cui siano presenti aggiunte o eliminazioni di cui non era a conoscenza. Quando un riquadro secondario viene eliminato tramite la barra dell'app della schermata Start, Windows rimuove semplicemente il riquadro. L'app stessa è responsabile del rilascio di tutte le risorse usate dal riquadro secondario. Quando i riquadri secondari vengono copiati nel cloud, le notifiche di tipo riquadro o badge correnti nel riquadro secondario, le notifiche pianificate, i canali di notifica push e gli URI (Uniform Resource Identifier) usati con le notifiche periodiche non vengono copiati con il riquadro secondario e devono essere nuovamente configurati.
  • Un'app deve usare ID univoci significativi e ricreabili per i riquadri secondari. L'uso di ID riquadri secondari prevedibili significativi per un'app consente all'app di comprendere cosa fare con questi riquadri quando vengono visualizzati in una nuova installazione in un nuovo computer.
    • In fase di esecuzione, l'app può verificare se esiste un riquadro specifico.
    • Puoi chiedere alla piattaforma di riquadri secondari di restituire il set di tutti i riquadri secondari appartenenti a un'app specifica. L'uso di ID significativi e univoci per questi riquadri consente all'app di esaminare il set di riquadri secondari ed eseguire azioni appropriate. Ad esempio, per un'app di social media, gli ID possono identificare i singoli contatti per i quali sono stati creati i riquadri.
  • I riquadri secondari, come tutti i riquadri nella schermata Start, sono punti di accesso dinamici che possono essere aggiornati di frequente con nuovi contenuti. I riquadri secondari possono visualizzare notifiche e aggiornamenti usando gli stessi meccanismi di qualsiasi altro riquadro. Per altre informazioni, vedere Scegliere un metodo di recapito delle notifiche.