SecondaryTile Constructeurs

Définition

Espace de noms:

Windows.UI.StartScreen

Surcharges

SecondaryTile()	Crée un objet SecondaryTile . L’appelant doit ensuite définir toutes les propriétés obligatoires via l’objet avant de tenter d’épingler, de mettre à jour ou de supprimer la vignette. Dans une application de bureau, avant d’utiliser une instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow.
SecondaryTile(String)	Crée un objet SecondaryTile avec un ID spécifique. Cette forme du constructeur doit être utilisée pour créer un objet de vignette secondaire afin d’effectuer une mise à jour ou une suppression de vignette. Dans une application de bureau, avant d’utiliser une instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow.
SecondaryTile(String, String, String, Uri, TileSize)	Crée un objet SecondaryTile qui inclut toutes les propriétés obligatoires requises pour créer une vignette moyenne. Dans une application de bureau, avant d’utiliser une instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow.
SecondaryTile(String, String, String, String, TileOptions, Uri)	Notes Ce constructeur peut être modifié ou indisponible pour les mises en production après Windows 8.1. Utilisez plutôt SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) . Crée un objet SecondaryTile en tant que vignette moyenne. Dans une application de bureau, avant d’utiliser une instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow.
SecondaryTile(String, String, String, String, TileOptions, Uri, Uri)	Notes Ce constructeur peut être modifié ou indisponible pour les mises en production après Windows 8.1. Utilisez plutôt SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) et fournissez d’autres tailles de vignette et options via la méthode SecondaryTile.VisualElements . Crée un objet SecondaryTile sous forme de vignette large. Dans une application de bureau, avant d’utiliser une instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow. Sur Windows Phone 8.1, toutes les vignettes, y compris les vignettes secondaires, sont épinglées en tant que vignettes moyennes, après quoi elles peuvent être redimensionnées par l’utilisateur. Ce constructeur fournit cette option de redimensionnement sur une vignette large.

SecondaryTile()

Crée un objet SecondaryTile . L’appelant doit ensuite définir toutes les propriétés obligatoires via l’objet avant de tenter d’épingler, de mettre à jour ou de supprimer la vignette.

Dans une application de bureau, avant d’utiliser une instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow.

public:
 SecondaryTile();

 SecondaryTile();

public SecondaryTile();

function SecondaryTile()

Public Sub New ()

Remarques

Les propriétés de vignette obligatoires, telles que le nom d’affichage, doivent être définies par le biais d’appels à d’autres méthodes de cette classe avant que la vignette puisse être activée.

SecondaryTile(String)

Crée un objet SecondaryTile avec un ID spécifique. Cette forme du constructeur doit être utilisée pour créer un objet de vignette secondaire afin d’effectuer une mise à jour ou une suppression de vignette.

Dans une application de bureau, avant d’utiliser une instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow.

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

 SecondaryTile(winrt::hstring const& tileId);

public SecondaryTile(string tileId);

function SecondaryTile(tileId)

Public Sub New (tileId As String)

Paramètres

tileId

String

Platform::String

winrt::hstring

Chaîne qui identifie de façon unique la vignette dans votre application. Choisissez un ID unique descriptif et significatif pour votre application. Si vous fournissez le même ID que celui d’une vignette secondaire existante, la vignette secondaire existante est remplacée.

Remarques

L’ID unique que vous utilisez pour créer cette vignette peut être utilisé ultérieurement pour la mettre à jour ou la supprimer.

D’autres propriétés de vignette obligatoires, telles que le nom d’affichage, doivent être définies par le biais d’appels à d’autres méthodes de cette classe avant que la vignette puisse être activée.

SecondaryTile(String, String, String, Uri, TileSize)

Crée un objet SecondaryTile qui inclut toutes les propriétés obligatoires requises pour créer une vignette moyenne.

Dans une application de bureau, avant d’utiliser une instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de 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)

Paramètres

tileId

String

Platform::String

winrt::hstring

Chaîne qui identifie de façon unique la vignette dans le package de votre application. Choisissez un ID unique descriptif et significatif pour votre application. Il est limité à 64 caractères et doit commencer par un nombre ou une lettre et être composé des caractères a-z, A-Z, 0-9, point (.) ou trait de soulignement (_). Si vous fournissez le même ID que celui d’une vignette secondaire existante, la vignette secondaire existante est remplacée. Peut être défini ou récupéré via la propriété TileId .

displayName

String

Platform::String

winrt::hstring

Nom à afficher sur la vignette, dans l’info-bulle de la vignette et lors de l’affichage de petites vignettes, par exemple sur les écrans Applications ou résultats de la recherche. Cette chaîne équivaut au nom d’affichage indiqué dans le manifeste de la vignette main. Il est limité à 256 caractères, mais dans la pratique doit être court pour éviter la troncation. Cette valeur peut être définie ou récupérée via la propriété DisplayName .

Le nom d’affichage s’affiche uniquement sur la vignette secondaire large sur Windows Phone 8.1.

arguments

String

Platform::String

winrt::hstring

Chaîne définie par l’application significative pour l’application appelante. Cette chaîne d’argument est renvoyée à l’application lorsque l’application est activée à partir de la vignette secondaire. Il sera tronqué au bout de 2 048 caractères. Peut être défini ou récupéré via la propriété Arguments .

Notes

Ce paramètre doit être encodé en URL pour Windows Phone applications Silverlight 8.1. Tous les autres types d’applications peuvent utiliser leur propre structure.

square150x150Logo

Uri Uri

Référence à une image de logo moyenne stockée dans un URI (Uniform Resource Identifier). Peut être défini ou récupéré via la propriété SecondaryTileVisualElements.Square150x150Logo . Cette valeur peut être exprimée à l’aide de l’un des schémas suivants : chemin ms-appx:/// A dans le package d’application déployé. Ce chemin d’accès est résolu pour les langues et le plateau PPP pris en charge par l’application.ms-appdata:///local/ Un fichier trouvé dans le stockage de l’application par utilisateur.

desiredSize

TileSize

Taille de la vignette à épingler. Cette valeur doit être Default (qui fournit le comportement de Windows 8), Square150x150 ou Wide310x150. Toute autre valeur TileSize entraîne la levée d’une exception pendant l’exécution.

Le paramètre desiredSize est ignoré sur Windows Phone 8.1. Sur le téléphone, toutes les vignettes, y compris les vignettes secondaires, sont épinglées en tant que vignettes moyennes, après quoi elles peuvent être redimensionnées par l’utilisateur.

SecondaryTile(String, String, String, String, TileOptions, Uri)

Notes

Ce constructeur peut être modifié ou indisponible pour les mises en production après Windows 8.1. Utilisez plutôt SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) .

Crée un objet SecondaryTile en tant que vignette moyenne.

Dans une application de bureau, avant d’utiliser une instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de 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)

Paramètres

tileId

String

Platform::String

winrt::hstring

Chaîne qui identifie de façon unique la vignette dans le package de votre application. Choisissez un ID unique descriptif et significatif pour votre application. Il est limité à 64 caractères et doit commencer par un nombre ou une lettre et être composé des caractères a-z, A-Z, 0-9, point (.) ou trait de soulignement (_). Si vous fournissez le même ID que celui d’une vignette secondaire existante, la vignette secondaire existante est remplacée. Peut être défini ou récupéré via la propriété TileId .

shortName

String

Platform::String

winrt::hstring

Nom court à afficher directement sur la vignette si l’application choisit de le faire. Tout ce qui dépasse 40 caractères sera tronqué. L’utilisateur a la possibilité de modifier cette valeur dans le cadre du processus d’épinglage. Peut être défini ou récupéré via la propriété ShortName .

Notes

Cette valeur est utilisée uniquement dans Windows 8 et est déconseillée en faveur de displayName dans les versions ultérieures.

displayName

String

Platform::String

winrt::hstring

Nom à afficher sur la vignette, dans l’info-bulle de la vignette et lors de l’affichage de petites vignettes, par exemple sur les écrans Applications ou résultats de la recherche. Cette chaîne équivaut au nom d’affichage indiqué dans le manifeste de la vignette main. Il est limité à 256 caractères, mais dans la pratique doit être court pour éviter la troncation. Cette valeur peut être définie ou récupérée via la propriété DisplayName .

Le nom d’affichage s’affiche uniquement sur la vignette secondaire large sur Windows Phone 8.1.

arguments

String

Platform::String

winrt::hstring

Chaîne définie par l’application significative pour l’application appelante. Cette chaîne d’argument est renvoyée à l’application lorsque l’application est activée à partir de la vignette secondaire. Il sera tronqué au bout de 2 048 caractères. Peut être défini ou récupéré via la propriété Arguments .

tileOptions

TileOptions

Valeur qui spécifie différentes options, telles que si le nom sera affiché sur la vignette secondaire. Peut être défini ou récupéré via la propriété TileOptions .

logoReference

Uri Uri

Référence à une image de logo carrée stockée dans un URI (Uniform Resource Identifier). Peut être défini ou récupéré via la propriété Logo . Cette valeur peut être exprimée à l’aide de l’un des schémas suivants : chemin ms-appx:/// A dans le package d’application déployé. Ce chemin d’accès est résolu pour les langues et le plateau PPP pris en charge par l’application.ms-appdata:///local/ Un fichier trouvé dans le stockage de l’application par utilisateur.

Attributs

DeprecatedAttribute

SecondaryTile(String, String, String, String, TileOptions, Uri, Uri)

Notes

Ce constructeur peut être modifié ou indisponible pour les mises en production après Windows 8.1. Utilisez plutôt SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) et fournissez d’autres tailles de vignette et options via la méthode SecondaryTile.VisualElements .

Crée un objet SecondaryTile sous forme de vignette large.

Dans une application de bureau, avant d’utiliser une instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow.

Sur Windows Phone 8.1, toutes les vignettes, y compris les vignettes secondaires, sont épinglées en tant que vignettes moyennes, après quoi elles peuvent être redimensionnées par l’utilisateur. Ce constructeur fournit cette option de redimensionnement sur une vignette large.

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)

Paramètres

tileId

String

Platform::String

winrt::hstring

Chaîne qui identifie de façon unique la vignette dans le package de votre application. Choisissez un ID unique descriptif et significatif pour votre application. Il est limité à 64 caractères et doit commencer par un nombre ou une lettre et être composé des caractères a-z, A-Z, 0-9, point (.) ou trait de soulignement (_). Si vous fournissez le même ID que celui d’une vignette secondaire existante, la vignette secondaire existante est remplacée. Peut être défini ou récupéré via la propriété TileId .

shortName

String

Platform::String

winrt::hstring

Nom court à afficher directement sur la vignette si l’application choisit de le faire. Tout ce qui dépasse 40 caractères sera tronqué. L’utilisateur a la possibilité de modifier cette valeur dans le cadre du processus d’épinglage. Peut être défini ou récupéré via la propriété ShortName .

Notes

Cette valeur est utilisée uniquement dans Windows 8 et est déconseillée en faveur de displayName dans les versions ultérieures.

displayName

String

Platform::String

winrt::hstring

Nom à afficher sur la vignette, dans l’info-bulle de la vignette et lors de l’affichage de petites vignettes, par exemple sur les écrans Applications ou résultats de la recherche. Cette chaîne équivaut au nom d’affichage indiqué dans le manifeste de la vignette main. Il est limité à 256 caractères, mais dans la pratique doit être court pour éviter la troncation. Cette valeur peut être définie ou récupérée via la propriété DisplayName .

Le nom d’affichage s’affiche uniquement sur la vignette secondaire large sur Windows Phone 8.1.

arguments

String

Platform::String

winrt::hstring

Chaîne définie par l’application significative pour l’application appelante. Cette chaîne d’argument est renvoyée à l’application lorsque l’application est activée à partir de la vignette secondaire. Il sera tronqué au bout de 2 048 caractères. Peut être défini ou récupéré via la propriété Arguments .

tileOptions

TileOptions

Valeur qui spécifie différentes options, telles que si le nom sera affiché sur la vignette secondaire. Peut être défini ou récupéré via la propriété TileOptions .

logoReference

Uri Uri

Référence à une image de logo moyenne stockée dans un URI (Uniform Resource Identifier). Peut être défini ou récupéré via la propriété Square150x150Logo . Cette valeur peut être exprimée à l’aide de l’un des schémas suivants : chemin ms-appx:/// A dans le package d’application déployé. Ce chemin d’accès est résolu pour les langues et le plateau PPP pris en charge par l’application.ms-appdata:///local/ Un fichier trouvé dans le stockage de l’application par utilisateur.

wideLogoReference

Uri Uri

Référence à une image de logo large stockée dans un URI (Uniform Resource Identifier). Peut être défini ou récupéré via la propriété WideLogo . Cette valeur peut être exprimée à l’aide de l’un des schémas suivants : chemin ms-appx:/// A dans le package d’application déployé. Ce chemin d’accès est résolu pour les langues et le plateau PPP pris en charge par l’application.ms-appdata:///local/ Un fichier trouvé dans le stockage de l’application par utilisateur.

Attributs

DeprecatedAttribute