SecondaryTile Costruttori

Definizione

Spazio dei nomi:

Windows.UI.StartScreen

Overload

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, 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.
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()

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.

public:
 SecondaryTile();

 SecondaryTile();

public SecondaryTile();

function SecondaryTile()

Public Sub New ()

Commenti

Per attivare il riquadro, è necessario impostare le proprietà obbligatorie del riquadro, ad esempio il nome visualizzato, tramite chiamate ad altri metodi di questa classe.

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.

public:
 SecondaryTile(Platform::String ^ tileId);

 SecondaryTile(winrt::hstring const& tileId);

public SecondaryTile(string tileId);

function SecondaryTile(tileId)

Public Sub New (tileId As String)

Parametri

tileId

String

Platform::String

winrt::hstring

Stringa che identificherà in modo univoco il riquadro all'interno dell'app. Scegliere un ID univoco descrittivo e significativo per l'app. Se si specifica lo stesso ID di un riquadro secondario esistente, il riquadro secondario esistente verrà sovrascritto.

Commenti

L'ID univoco usato per creare questo riquadro può essere usato in seguito per aggiornarlo o eliminarlo.

È necessario impostare altre proprietà di riquadro obbligatorie, ad esempio il nome visualizzato, tramite chiamate ad altri metodi di questa classe prima che il riquadro possa essere attivato.

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.

public:
 SecondaryTile(Platform::String ^ tileId, Platform::String ^ displayName, Platform::String ^ arguments, Uri ^ square150x150Logo, TileSize desiredSize);

 SecondaryTile(winrt::hstring const& tileId, winrt::hstring const& displayName, winrt::hstring const& arguments, Uri const& square150x150Logo, TileSize const& desiredSize);

public SecondaryTile(string tileId, string displayName, string arguments, System.Uri square150x150Logo, TileSize desiredSize);

function SecondaryTile(tileId, displayName, arguments, square150x150Logo, desiredSize)

Public Sub New (tileId As String, displayName As String, arguments As String, square150x150Logo As Uri, desiredSize As TileSize)

Parametri

tileId

String

Platform::String

winrt::hstring

Stringa che identificherà in modo univoco il riquadro all'interno del pacchetto dell'app. Scegliere un ID univoco descrittivo e significativo per l'app. È limitato a 64 caratteri e deve iniziare con un numero o una lettera ed essere composto dai caratteri a-z, A-Z, 0-9, punto (.) o carattere di sottolineatura (_). Se si specifica lo stesso ID di un riquadro secondario esistente, il riquadro secondario esistente verrà sovrascritto. Può essere impostato o recuperato tramite la proprietà TileId .

displayName

String

Platform::String

winrt::hstring

Nome da visualizzare nel riquadro, nella descrizione comando del riquadro e quando vengono visualizzati riquadri di piccole dimensioni, ad esempio nelle schermate App o risultati di ricerca. Questa stringa equivale al nome visualizzato specificato nel manifesto per il riquadro principale. È limitato a 256 caratteri, ma in pratica deve essere mantenuto breve per evitare il troncamento. Questo valore può essere impostato o recuperato tramite la proprietà DisplayName .

Il nome visualizzato viene visualizzato solo nel riquadro secondario wide in Windows Phone 8.1.

arguments

String

Platform::String

winrt::hstring

Stringa definita dall'app significativa per l'applicazione chiamante. Questa stringa di argomento viene passata all'app quando l'app viene attivata dal riquadro secondario. Verrà troncato dopo 2048 caratteri. Può essere impostato o recuperato tramite la proprietà Arguments .

Nota

Questo parametro deve essere codificato con URL per Windows Phone app Silverlight 8.1. Tutti gli altri tipi di app possono usare la propria struttura.

square150x150Logo

Uri Uri

Riferimento a un'immagine di logo media archiviata in un URI (Uniform Resource Identifier). Può essere impostato o recuperato tramite la proprietà SecondaryTileVisualElements.Square150x150Logo . Questo valore può essere espresso usando uno di questi schemi: ms-appx:/// A percorso all'interno del pacchetto dell'app distribuito. Questo percorso viene risolto per le lingue e l'altopiano DPI supportato dall'app.file ms-appdata:///local/ A disponibile nell'archiviazione delle app per utente.

desiredSize

TileSize

Dimensioni del riquadro da aggiungere. Questo valore deve essere Default (che fornisce il comportamento di Windows 8), Square150x150 o Wide310x150. Qualsiasi altro valore TileSize causa la generazione di un'eccezione durante il runtime.

Il parametro desiredSize viene ignorato in Windows Phone 8.1. Sul telefono, tutti i riquadri, inclusi i riquadri secondari, vengono aggiunti come riquadri medi, dopodiché possono essere ridimensionati dall'utente.

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, sarà necessario associare l'oggetto all'handle della finestra del proprietario. Per altre informazioni ed esempi di codice, vedere Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

public:
 SecondaryTile(Platform::String ^ tileId, Platform::String ^ shortName, Platform::String ^ displayName, Platform::String ^ arguments, TileOptions tileOptions, Uri ^ logoReference);

/// [Windows.Foundation.Metadata.Deprecated("SecondaryTile(string, string, string, string, Windows.UI.StartScreen.TileOptions, Windows.Foundation.Uri) may be altered or unavailable for releases after Windows Phone 8.1. Instead, use SecondaryTile(string, string, string, Windows.Foundation.Uri, Windows.UI.StartScreen.TileSize).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
 SecondaryTile(winrt::hstring const& tileId, winrt::hstring const& shortName, winrt::hstring const& displayName, winrt::hstring const& arguments, TileOptions const& tileOptions, Uri const& logoReference);

[Windows.Foundation.Metadata.Deprecated("SecondaryTile(string, string, string, string, Windows.UI.StartScreen.TileOptions, Windows.Foundation.Uri) may be altered or unavailable for releases after Windows Phone 8.1. Instead, use SecondaryTile(string, string, string, Windows.Foundation.Uri, Windows.UI.StartScreen.TileSize).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
public SecondaryTile(string tileId, string shortName, string displayName, string arguments, TileOptions tileOptions, System.Uri logoReference);

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

Public Sub New (tileId As String, shortName As String, displayName As String, arguments As String, tileOptions As TileOptions, logoReference As Uri)

Parametri

tileId

String

Platform::String

winrt::hstring

Stringa che identificherà in modo univoco il riquadro all'interno del pacchetto dell'app. Scegliere un ID univoco descrittivo e significativo per l'app. È limitato a 64 caratteri e deve iniziare con un numero o una lettera ed essere composto dai caratteri a-z, A-Z, 0-9, punto (.) o carattere di sottolineatura (_). Se si specifica lo stesso ID di un riquadro secondario esistente, il riquadro secondario esistente verrà sovrascritto. Può essere impostato o recuperato tramite la proprietà TileId .

shortName

String

Platform::String

winrt::hstring

Nome breve da visualizzare direttamente nel riquadro se l'app sceglie di farlo. Qualsiasi elemento di oltre 40 caratteri verrà troncato. L'utente ha la possibilità di modificare questo valore come parte del processo di aggiunta. Può essere impostato o recuperato tramite la proprietà ShortName .

Nota

Questo valore viene usato solo in Windows 8 ed è deprecato a favore del displayName nelle versioni successive.

displayName

String

Platform::String

winrt::hstring

Nome da visualizzare nel riquadro, nella descrizione comando del riquadro e quando vengono visualizzati piccoli riquadri, ad esempio nelle schermate App o risultati di ricerca. Questa stringa equivale al nome visualizzato specificato nel manifesto per il riquadro principale. È limitato a 256 caratteri, ma in pratica deve essere mantenuto breve per evitare il troncamento. Questo valore può essere impostato o recuperato tramite la proprietà DisplayName .

Il nome visualizzato viene visualizzato solo nel riquadro secondario wide in Windows Phone 8.1.

arguments

String

Platform::String

winrt::hstring

Stringa definita dall'app significativa per l'applicazione chiamante. Questa stringa di argomento viene passata all'app quando l'app viene attivata dal riquadro secondario. Verrà troncato dopo 2048 caratteri. Può essere impostato o recuperato tramite la proprietà Arguments .

tileOptions

TileOptions

Valore che specifica varie opzioni, ad esempio se il nome verrà visualizzato nel riquadro secondario. Può essere impostato o recuperato tramite la proprietà TileOptions .

logoReference

Uri Uri

Riferimento a un'immagine del logo quadrato archiviata in un URI (Uniform Resource Identifier). Può essere impostato o recuperato tramite la proprietà Logo . Questo valore può essere espresso usando uno di questi schemi: percorso ms-appx:/// A all'interno del pacchetto dell'app distribuito. Questo percorso viene risolto per le lingue e l'altopiano DPI supportato dall'app.file ms-appdata:///local/ A trovato nell'archivio app per utente.

Attributi

DeprecatedAttribute

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 riquadro 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, sarà necessario associare l'oggetto all'handle della finestra del proprietario. Per altre informazioni ed esempi di codice, vedere 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 il quale possono essere ridimensionati dall'utente. Questo costruttore offre l'opzione di ridimensionamento in un riquadro wide.

public:
 SecondaryTile(Platform::String ^ tileId, Platform::String ^ shortName, Platform::String ^ displayName, Platform::String ^ arguments, TileOptions tileOptions, Uri ^ logoReference, Uri ^ wideLogoReference);

/// [Windows.Foundation.Metadata.Deprecated("SecondaryTile(string, string, string, string, Windows.UI.StartScreen.TileOptions, Windows.Foundation.Uri, Windows.Foundation.Uri) may be altered or unavailable for releases after Windows Phone 8.1. Instead, use SecondaryTile(string, string, string, Windows.Foundation.Uri, Windows.UI.StartScreen.TileSize).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
 SecondaryTile(winrt::hstring const& tileId, winrt::hstring const& shortName, winrt::hstring const& displayName, winrt::hstring const& arguments, TileOptions const& tileOptions, Uri const& logoReference, Uri const& wideLogoReference);

[Windows.Foundation.Metadata.Deprecated("SecondaryTile(string, string, string, string, Windows.UI.StartScreen.TileOptions, Windows.Foundation.Uri, Windows.Foundation.Uri) may be altered or unavailable for releases after Windows Phone 8.1. Instead, use SecondaryTile(string, string, string, Windows.Foundation.Uri, Windows.UI.StartScreen.TileSize).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
public SecondaryTile(string tileId, string shortName, string displayName, string arguments, TileOptions tileOptions, System.Uri logoReference, System.Uri wideLogoReference);

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

Public Sub New (tileId As String, shortName As String, displayName As String, arguments As String, tileOptions As TileOptions, logoReference As Uri, wideLogoReference As Uri)

Parametri

tileId

String

Platform::String

winrt::hstring

Stringa che identifica in modo univoco il riquadro all'interno del pacchetto dell'app. Scegliere un ID univoco descrittivo e significativo per l'app. È limitato a 64 caratteri e deve iniziare con un numero o una lettera e deve essere composto dai caratteri a-z, A-Z, 0-9, periodo (.) o sottolineatura (_). Se si specifica lo stesso ID di un riquadro secondario esistente, il riquadro secondario esistente verrà sovrascritto. Può essere impostato o recuperato tramite la proprietà TileId .

shortName

String

Platform::String

winrt::hstring

Nome breve da visualizzare direttamente nel riquadro se l'app sceglie di farlo. Qualsiasi elemento di oltre 40 caratteri verrà troncato. L'utente ha la possibilità di modificare questo valore come parte del processo di aggiunta. Può essere impostato o recuperato tramite la proprietà ShortName .

Nota

Questo valore viene usato solo in Windows 8 ed è deprecato a favore del displayName nelle versioni successive.

displayName

String

Platform::String

winrt::hstring

Nome da visualizzare nel riquadro, nella descrizione comando del riquadro e quando vengono visualizzati piccoli riquadri, ad esempio nelle schermate App o risultati di ricerca. Questa stringa equivale al nome visualizzato specificato nel manifesto per il riquadro principale. È limitato a 256 caratteri, ma in pratica deve essere mantenuto breve per evitare il troncamento. Questo valore può essere impostato o recuperato tramite la proprietà DisplayName .

Il nome visualizzato viene visualizzato solo nel riquadro secondario wide in Windows Phone 8.1.

arguments

String

Platform::String

winrt::hstring

Stringa definita dall'app significativa per l'applicazione chiamante. Questa stringa di argomento viene passata all'app quando l'app viene attivata dal riquadro secondario. Verrà troncato dopo 2048 caratteri. Può essere impostato o recuperato tramite la proprietà Arguments .

tileOptions

TileOptions

Valore che specifica varie opzioni, ad esempio se il nome verrà visualizzato nel riquadro secondario. Può essere impostato o recuperato tramite la proprietà TileOptions .

logoReference

Uri Uri

Riferimento a un'immagine di logo medio archiviata in un URI (Uniform Resource Identifier). Può essere impostato o recuperato tramite la proprietà Square150x150Logo . Questo valore può essere espresso usando uno di questi schemi: percorso ms-appx:/// A all'interno del pacchetto dell'app distribuito. Questo percorso viene risolto per le lingue e l'altopiano DPI supportato dall'app.file ms-appdata:///local/ A trovato nell'archivio app per utente.

wideLogoReference

Uri Uri

Riferimento a un'immagine di logo a livello archiviata in un URI (Uniform Resource Identifier). Può essere impostato o recuperato tramite la proprietà WideLogo . Questo valore può essere espresso usando uno di questi schemi: percorso ms-appx:/// A all'interno del pacchetto dell'app distribuito. Questo percorso viene risolto per le lingue e l'altopiano DPI supportato dall'app.file ms-appdata:///local/ A trovato nell'archivio app per utente.

Attributi

DeprecatedAttribute