SecondaryTile Classe

Definizione

Spazio dei nomi:

Windows.UI.StartScreen

Crea, enumera e fornisce informazioni su un riquadro secondario.

In un'app desktop prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, sarà necessario associare l'oggetto all'handle della finestra del proprietario. Per altre informazioni ed esempi di codice, vedere Visualizzare oggetti interfaccia utente WinRT che dipendono da CoreWindow e Aggiungere riquadri secondari dalle app desktop.

public ref class SecondaryTile sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory2, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SecondaryTile final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory2), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SecondaryTile

function SecondaryTile(tileId, shortName, displayName, arguments, tileOptions, logoReference, wideLogoReference)

Public NotInheritable Class SecondaryTile

Ereditarietà

Object Platform::Object IInspectable SecondaryTile

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Nell'esempio seguente viene creato e aggiunto un riquadro secondario alla schermata Start.

using Windows.UI.StartScreen;

// Prepare package images for all four tile sizes in our tile to be pinned as well as for the square30x30 logo used in the Apps view.  
Uri square150x150Logo = new Uri("ms-appx:///Assets/square150x150Tile-sdk.png");
Uri wide310x150Logo = new Uri("ms-appx:///Assets/wide310x150Tile-sdk.png");
Uri square310x310Logo = new Uri("ms-appx:///Assets/square310x310Tile-sdk.png"); 
Uri square30x30Logo = new Uri("ms-appx:///Assets/square30x30Tile-sdk.png");

// During creation of secondary tile, an application may set additional arguments on the tile that will be passed in during activation.
// These arguments should be meaningful to the application. In this sample, we'll pass in the date and time the secondary tile was pinned.
string tileActivationArguments = MainPage.logoSecondaryTileId + " WasPinnedAt=" + DateTime.Now.ToLocalTime().ToString();

// Create a Secondary tile with all the required arguments.
// Note the last argument specifies what size the Secondary tile should show up as by default in the Pin to start fly out.
// It can be set to TileSize.Square150x150, TileSize.Wide310x150, or TileSize.Default.  
// If set to TileSize.Wide310x150, then the asset for the wide size must be supplied as well.
// TileSize.Default will default to the wide size if a wide size is provided, and to the medium size otherwise. 
SecondaryTile secondaryTile = new SecondaryTile(MainPage.logoSecondaryTileId,
                                                "Title text shown on the tile",
                                                tileActivationArguments,
                                                square150x150Logo,
                                                TileSize.Square150x150);

// Pin the tile
bool isPinned = await tile.RequestCreateAsync();
if (isPinned) {
    // Secondary tile successfully pinned.
} 
else {
    // Secondary tile not pinned.
}

Nell'esempio seguente viene illustrato come eliminare (unpin) un riquadro secondario usando il metodo RequestDeleteAsync . Si noti che in questo esempio si presuppone che il riquadro esista. Per determinare se il riquadro viene aggiunto prima di chiamare RequestDeleteAsync, vedere il metodo Exists .

// Check if the secondary tile is pinned
if (SecondaryTile.Exists(tileId)) {
    // Initialize a secondary tile with the same tile ID you want removed
    SecondaryTile toBeDeleted = new SecondaryTile(tileId);

    // And then unpin the tile
    bool isDeleted = await toBeDeleted.RequestDeleteAsync();
    if (isDeleted) {
        // Secondary tile successfully deleted.
    } else {
        // Secondary tile not deleted.
    }
}

Nell'esempio seguente viene illustrato come usare il metodo FindAllForPackageAsync per recuperare un elenco di ID per tutti i riquadri secondari creati per l'app chiamante e qualsiasi altra app nello stesso pacchetto.

// Get all secondary tiles
var tiles = await SecondaryTile.FindAllForPackageAsync();

Nell'esempio seguente viene illustrato come usare il metodo TileUpdateManager.createTileUpdaterForSecondaryTile per inviare una notifica a un riquadro secondario con un ID "SecondaryTile.Dynamic". Si noti che l'esempio fornisce sia una versione wide che quadrata della notifica perché l'utente ha il controllo su quale forma del riquadro viene visualizzata.

using NotificationsExtensions.TileContent;

// Define the notification context.
// Note: This sample contains an additional reference, NotificationsExtensions, which you can use in your apps
ITileWide310x150Text04 tileContent = TileContentFactory.CreateTileWide310x150Text04();
tileContent.TextBodyWrap.Text = "Sent to a secondary tile from NotificationsExtensions!";

// Provide a square version of the notification.
ITileSquare150x150Text04 squareContent = TileContentFactory.CreateTileSquare150x150Text04();
squareContent.TextBodyWrap.Text = "Sent to a secondary tile from NotificationExtensions!";
tileContent.Square150x150Content = squareContent;

// Send the notification to the secondary tile by creating a secondary tile updater
TileUpdateManager.CreateTileUpdaterForSecondaryTile(MainPage.dynamicTileId).Update(tileContent.CreateNotification());

Nell'esempio seguente viene illustrato come usare il metodo BadgeUpdateManager.createBadgeUpdaterForSecondaryTile per inviare una notifica di notifica numerica a un riquadro secondario con un ID "SecondaryTile.Dynamic".

using NotificationsExtensions.BadgeContent;

// Define the badge content
BadgeNumericNotificationContent badgeContent = new BadgeNumericNotificationContent(6);

// Send the notification to the secondary tile
BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile(MainPage.dynamicTileId).Update(badgeContent.CreateNotification());

Costruttori

SecondaryTile()	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.
SecondaryTile(String)	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.
SecondaryTile(String, String, String, String, TileOptions, Uri)	Nota Questo costruttore può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize). 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.
SecondaryTile(String, String, String, String, TileOptions, Uri, Uri)	Nota Questo costruttore può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) e fornire altre dimensioni e opzioni di riquadri tramite il metodo SecondaryTile.VisualElements . 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.
SecondaryTile(String, String, String, Uri, TileSize)	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.

Proprietà

Arguments	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.
BackgroundColor	Nota BackgroundColor può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece SecondaryTileVisualElements.BackgroundColor. Ottiene o imposta il colore di sfondo del riquadro.
DisplayName	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.
ForegroundText	Nota ForegroundText può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece SecondaryTileVisualElements.ForegroundText. Ottiene o imposta un valore che indica se il riquadro deve utilizzare testo scuro o chiaro.
LockScreenBadgeLogo	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. Nota L'indicazione che il riquadro secondario è idoneo per la presenza di una schermata di blocco non garantisce che ne abbia uno. Solo l'utente può aggiungere un'app a uno dei sette slot della schermata di blocco. Per altre informazioni, vedere Panoramica della schermata di blocco.
LockScreenDisplayBadgeAndTileText	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. Nota L'indicazione che il riquadro secondario è idoneo per la presenza di una schermata di blocco non garantisce che ne abbia uno. Solo l'utente può aggiungere un'app a uno dei sette slot della schermata di blocco, oltre a scegliere quale di essi può visualizzare informazioni dettagliate sul riquadro. Per altre informazioni, vedere Panoramica della schermata di blocco.
Logo	Nota Il logo può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece SecondaryTileVisualElements.Square150x150Logo. Ottiene o imposta l'immagine del logo utilizzata in un riquadro medio. Questa proprietà è necessaria quando si crea un riquadro quadrato o wide.
PhoneticName	Ottiene o imposta una versione fonetica del nome del riquadro secondario. Usato con le lingue basate su caratteri per l'ordinamento dell'interfaccia utente.
RoamingEnabled	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.
ShortName	Nota ShortName può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece SecondaryTile.DisplayName. Ottiene o imposta un nome breve da visualizzare direttamente nel riquadro. Nota A partire da Windows 8.1, questa proprietà viene ignorata e il nome visualizzato dichiarato nel manifesto viene usato nel relativo posto.
SmallLogo	Nota SmallLogo può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece SecondaryTileVisualElements.Square30x30Logo. 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.
TileId	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.
TileOptions	Nota TileOptions può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece SecondaryTile.VisualElements. Ottiene o imposta le opzioni disponibili per un riquadro secondario.
VisualElements	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)
WideLogo	Nota WideLogo può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece SecondaryTileVisualElements.Wide310x150Logo. 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.

Metodi

Exists(String)	Controlla se esiste un riquadro secondario specifico per l'app chiamante.
FindAllAsync()	Recupera un elenco di riquadri secondari creati per l'app chiamante.
FindAllAsync(String)	Recupera un elenco di riquadri secondari creati per un'altra app nello stesso pacchetto dell'app chiamante.
FindAllForPackageAsync()	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.
RequestCreateAsync()	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. Nota È consigliabile visualizzare il riquadro a comparsa Aggiungi all'avvio accanto al pulsante che ha richiamato la richiesta per creare il riquadro. È pertanto consigliabile usare il formato RequestCreateAsync(Point) di questo overload del metodo. 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.
RequestCreateAsync(Point)	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.
RequestCreateForSelectionAsync(Rect)	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.
RequestCreateForSelectionAsync(Rect, Placement)	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.
RequestDeleteAsync()	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.
RequestDeleteAsync(Point)	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.
RequestDeleteForSelectionAsync(Rect)	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.
RequestDeleteForSelectionAsync(Rect, Placement)	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.
UpdateAsync()	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.

Eventi

VisualElementsRequested

Generato quando viene effettuata una chiamata a RequestCreateAsync. Questo evento non viene generato in Windows Phone 8.1.

Vedi anche

• Linee guida per i riquadri secondari
• Esempio di riquadri secondari (Windows 10)
• esempio di modello Realtà mista