SecondaryTile Classe

Crea un oggetto SecondaryTile . Il chiamante deve quindi impostare qualsiasi proprietà obbligatoria tramite l'oggetto prima di tentare di aggiungere, aggiornare o eliminare il riquadro.

In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

Crea un oggetto SecondaryTile con un ID specifico. Questo formato del costruttore deve essere utilizzato per creare un oggetto riquadro secondario per eseguire un aggiornamento o un'eliminazione di riquadri.

In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

Crea un oggetto SecondaryTile come riquadro medio.

In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

Crea un oggetto SecondaryTile come riquadro wide.

In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

In Windows Phone 8.1, tutti i riquadri, inclusi i riquadri secondari, vengono aggiunti come riquadri medi, dopo di che possono essere ridimensionati dall'utente. Questo costruttore fornisce tale opzione per il ridimensionamento in un riquadro wide.

Crea un oggetto SecondaryTile che include tutte le proprietà obbligatorie necessarie per creare un riquadro medio.

In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

Ottiene o imposta un set definito dall'app di informazioni passate dal riquadro secondario all'app all'attivazione. Questa proprietà è necessaria quando si crea un riquadro.

Ottiene o imposta il colore di sfondo del riquadro.

Ottiene o imposta un nome associato e visualizzato nel riquadro. Questo nome viene visualizzato nel riquadro in Start, nella descrizione comando del riquadro accanto alla piccola rappresentazione di riquadri nell'elenco App e in alcune applicazioni Pannello di controllo. Questa proprietà è necessaria quando si crea un riquadro. È l'equivalente del nome visualizzato dichiarato nel manifesto per il riquadro principale dell'app.

In Windows Phone 8.1, il nome visualizzato viene visualizzato solo nel riquadro secondario wide.

Ottiene o imposta un valore che indica se il riquadro deve utilizzare testo scuro o chiaro.

Ottiene o imposta la posizione di un'immagine del logo badge per rappresentare il riquadro secondario nella schermata di blocco. Fornendo questa immagine, dichiari che il riquadro secondario è idoneo a visualizzare una notifica nella schermata di blocco. Se si vuole che il riquadro secondario sia idoneo anche per lo slot di riquadro dettagliato della schermata di blocco, è necessario impostare anche la proprietà LockScreenDisplayBadgeAndTileText su True.

Ottiene o imposta un valore che indica se il riquadro secondario è idoneo per visualizzare sia una notifica che un riquadro dettagliato nella schermata di blocco. Se si imposta questa proprietà su True, è necessario specificare anche un'immagine badge tramite la proprietà LockScreenBadgeLogo . Se non si vuole usare la funzionalità di riquadro dettagliata, fornire un'immagine badge tramite la proprietà LockScreenBadgeLogo e impostare LockScreenDisplayBadgeAndTileText su False.

Ottiene o imposta l'immagine del logo utilizzata in un riquadro medio. Questa proprietà è necessaria quando si crea un riquadro quadrato o wide.

Ottiene o imposta una versione fonetica del nome del riquadro secondario. Usato con le lingue basate su caratteri per l'ordinamento dell'interfaccia utente.

Ottiene o imposta un valore che determina se il riquadro secondario verrà riacquisto tramite il cloud quando l'app padre viene installata dall'utente, usando l'account Microsoft, in un altro computer. Si noti che a partire da Windows 8.1, il roaming è il comportamento predefinito. Questo è l'opposto del comportamento predefinito di Windows 8, in cui il roaming è stato esplicito.

Questa proprietà restituisce sempre false in Windows Phone 8.1.

Ottiene o imposta un nome breve da visualizzare direttamente nel riquadro.

Ottiene o imposta l'immagine di logo piccola, utilizzata nei risultati della ricerca, nell'elenco Tutti i programmi e in altre posizioni nell'interfaccia utente.

Il logo piccolo non viene usato con un riquadro secondario Windows Phone 8.1.

Ottiene o imposta una stringa univoca per identificare il riquadro all'interno del pacchetto. Questa proprietà è necessaria quando si crea o si elimina un riquadro.

Ottiene o imposta le opzioni disponibili per un riquadro secondario.

Ottiene un oggetto tramite il quale è possibile ottenere o impostare il colore di sfondo di un riquadro secondario, il testo in primo piano, le immagini del riquadro e le opzioni di visualizzazione del nome dell'app. A partire da Windows 8.1, le proprietà di questo oggetto sostituiscono queste proprietà SecondaryTile:

• SecondaryTile.BackgroundColor
• SecondaryTile.ForegroundText
• SecondaryTile.Logo
• SecondaryTile.SmallLogo
• SecondaryTile.WideLogo
• SecondaryTile.TileOptions (ad eccezione di CopyOnDeployment)

Ottiene o imposta l'immagine del logo usata in un riquadro secondario ampio. Questa proprietà è necessaria quando si crea un riquadro secondario wide e si offre all'utente l'opzione di un riquadro wide quando ridimensionano il riquadro.

Controlla se esiste un riquadro secondario specifico per l'app chiamante.

Recupera un elenco di riquadri secondari creati per l'app chiamante.

Recupera un elenco di riquadri secondari creati per un'altra app nello stesso pacchetto dell'app chiamante.

Recupera un elenco di riquadri secondari creati per tutte le app nel pacchetto dell'app chiamante.

Quando un'app viene avviata, deve sempre enumerare i riquadri secondari tramite questo metodo, 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 tramite il cloud, le notifiche di tipo riquadro o badge correnti nel riquadro secondario, le notifiche pianificate, i canali di notifica push e l'URI (Uniform Resource Identifier) usati con le notifiche periodiche non vengono copiate con il riquadro secondario e devono essere reimpostate.

Visualizza il riquadro a comparsa Aggiungi all'avvio , tramite il quale l'utente può confermare di voler creare il riquadro secondario, che a sua volta crea il riquadro. Gli overload di questo metodo consentono di specificare la posizione sullo schermo del riquadro a comparsa.

In Windows Phone 8.1, il riquadro secondario viene creato tramite questa chiamata senza mostrare all'utente un riquadro a comparsa, richiedendole la conferma o consentendo loro di scegliere una dimensione del riquadro o un testo del titolo. Si noti che quando si usa il metodo RequestCreateAsync per aggiungere un riquadro secondario in Windows Phone'app 8.x, l'app viene sospesa e l'utente viene visualizzato nella schermata Start. Questa stessa chiamata API su un PC non sospende il programma. Tenere quindi presente che qualsiasi codice chiamato dopo RequestCreateAsync non è garantito che venga eseguito prima che l'app venga sospesa. Per evitare questo potenziale problema, devi usare l'evento OnSuspended dell'app per eseguire qualsiasi codice, ad esempio l'aggiornamento del riquadro aggiunto, che deve essere eseguito prima della sospensione dell'app. Per visualizzare un esempio di questo modello, scaricare ed eseguire l'aggiornamento riquadro nell'esempio di sospensione.

Visualizza il riquadro a comparsa Aggiungi alla schermata Start sopra una posizione specificata, tramite cui l'utente può confermare di voler creare il riquadro secondario, che a sua volta crea il riquadro.

In Windows Phone 8.1, il riquadro secondario viene creato tramite questa chiamata senza mostrare all'utente un riquadro a comparsa, richiedendole la conferma o consentendo loro di scegliere una dimensione del riquadro o un testo del titolo. Si noti che quando si usa il metodo RequestCreateAsync per aggiungere un riquadro secondario in Windows Phone'app 8.x, l'app viene sospesa e l'utente viene visualizzato nella schermata Start. Questa stessa chiamata API su un PC non sospende il programma. Tenere quindi presente che qualsiasi codice chiamato dopo RequestCreateAsync non è garantito che venga eseguito prima che l'app venga sospesa. Per evitare questo potenziale problema, devi usare l'evento OnSuspended dell'app per eseguire qualsiasi codice, ad esempio l'aggiornamento del riquadro aggiunto, che deve essere eseguito prima della sospensione dell'app. Per visualizzare un esempio di questo modello, scaricare ed eseguire l'aggiornamento riquadro nell'esempio di sospensione.

Visualizza il riquadro a comparsa Aggiungi a Start sopra un'area specificata. Questo riquadro a comparsa viene usato dall'utente per confermare che vuole creare il riquadro secondario, che a sua volta crea il riquadro.

In Windows Phone 8.1, il riquadro secondario viene creato tramite questa chiamata senza visualizzare l'utente in un riquadro a comparsa, richiedendole la conferma o consentendo loro di scegliere una dimensione del riquadro o un testo del titolo. Si noti che quando si usa il metodo RequestCreateAsync per aggiungere un riquadro secondario in Windows Phone'app 8.x, l'app viene sospesa e l'utente viene visualizzato nella schermata Start. Questa stessa chiamata API su un PC non sospende il programma. Pertanto, tenere presente che qualsiasi codice chiamato dopo RequestCreateAsync non è garantito che venga eseguito prima che l'app venga sospesa. Per evitare questo potenziale problema, è consigliabile usare l'evento OnSuspended dell'app per eseguire qualsiasi codice, ad esempio l'aggiornamento del riquadro aggiunto, che deve essere eseguito prima della sospensione dell'app. Per visualizzare un esempio di questo modello, scaricare ed eseguire l'aggiornamento Riquadro nell'esempio di sospensione.

Visualizza il riquadro a comparsa Aggiungi a Start sul lato specificato di un'area specificata. Questo riquadro a comparsa viene usato dall'utente per confermare che vogliono creare il riquadro secondario, che a sua volta crea il riquadro.

In Windows Phone 8.1, il riquadro secondario viene creato tramite questa chiamata senza visualizzare l'utente in un riquadro a comparsa, richiedendole la conferma o consentendo loro di scegliere una dimensione del riquadro o un testo del titolo. Si noti che quando si usa il metodo RequestCreateAsync per aggiungere un riquadro secondario in Windows Phone'app 8.x, l'app viene sospesa e l'utente viene visualizzato nella schermata Start. Questa stessa chiamata API su un PC non sospende il programma. Pertanto, tenere presente che qualsiasi codice chiamato dopo RequestCreateAsync non è garantito che venga eseguito prima che l'app venga sospesa. Per evitare questo potenziale problema, è consigliabile usare l'evento OnSuspended dell'app per eseguire qualsiasi codice, ad esempio l'aggiornamento del riquadro aggiunto, che deve essere eseguito prima della sospensione dell'app. Per visualizzare un esempio di questo modello, scaricare ed eseguire l'aggiornamento Riquadro nell'esempio di sospensione.

Visualizza il riquadro a comparsa Rimuovi dal riquadro a comparsa Start. Questo riquadro a comparsa consente all'utente di confermare la rimozione del riquadro secondario.

Visualizza il riquadro a comparsa Rimuovi dal riquadro a comparsa Start in un punto specificato. Questo riquadro a comparsa consente all'utente di confermare la rimozione del riquadro secondario.

Visualizza il riquadro a comparsa Unpin from Start sopra un'area specificata. Questo riquadro a comparsa consente all'utente di confermare la rimozione del riquadro secondario.

Visualizza il riquadro a comparsa Annulla dal riquadro a comparsa Start sul lato specificato di un'area specificata. Questo riquadro a comparsa consente all'utente di confermare la rimozione del riquadro secondario.

Aggiornamenti un riquadro secondario dopo che tale riquadro viene aggiunto alla schermata Start.

In Windows Phone 8.1 l'app viene sospesa e l'utente viene visualizzato nella schermata Start quando viene aggiunto un riquadro secondario. Pertanto, tenere presente che qualsiasi codice chiamato dopo RequestCreateAsync non è garantito che venga eseguito prima che l'app venga sospesa. Per evitare questo potenziale problema, è consigliabile usare l'evento OnSuspended dell'app per eseguire qualsiasi codice, ad esempio l'aggiornamento del riquadro aggiunto, che deve essere eseguito prima della sospensione dell'app. Per visualizzare un esempio di questo modello, scaricare ed eseguire l'aggiornamento Riquadro nell'esempio di sospensione.

Generato quando viene effettuata una chiamata a RequestCreateAsync.

Questo evento non viene generato in Windows Phone 8.1.