SecondaryTile Constructores

Definición

Espacio de nombres:

Windows.UI.StartScreen

Sobrecargas

SecondaryTile()	Crea un objeto SecondaryTile . A continuación, el autor de la llamada debe establecer las propiedades obligatorias a través del objeto antes de intentar anclar, actualizar o eliminar el icono. En una aplicación de escritorio, antes de usar una instancia de esta clase de forma que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen de CoreWindow.
SecondaryTile(String)	Crea un objeto SecondaryTile con un identificador específico. Esta forma del constructor debe usarse para crear un objeto de icono secundario para realizar una actualización o eliminación de iconos. En una aplicación de escritorio, antes de usar una instancia de esta clase de forma que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen de CoreWindow.
SecondaryTile(String, String, String, Uri, TileSize)	Crea un objeto SecondaryTile que incluye todas las propiedades obligatorias necesarias para crear un icono medio. En una aplicación de escritorio, antes de usar una instancia de esta clase de forma que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen de CoreWindow.
SecondaryTile(String, String, String, String, TileOptions, Uri)	Nota Este constructor puede modificarse o no estar disponible para las versiones después de Windows 8.1. En su lugar, use SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize). Crea un objeto SecondaryTile como un icono medio. En una aplicación de escritorio, antes de usar una instancia de esta clase de forma que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen de CoreWindow.
SecondaryTile(String, String, String, String, TileOptions, Uri, Uri)	Nota Este constructor puede modificarse o no estar disponible para las versiones después de Windows 8.1. En su lugar, use SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) y proporcione otros tamaños y opciones de icono a través del método SecondaryTile.VisualElements . Crea un objeto SecondaryTile como un icono ancho. En una aplicación de escritorio, antes de usar una instancia de esta clase de forma que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen de CoreWindow. En Windows Phone 8.1, todos los iconos (incluidos los iconos secundarios) se anclan como iconos medianos, después de los cuales el usuario puede cambiar el tamaño. Este constructor proporciona la opción de cambiar el tamaño a un icono ancho.

SecondaryTile()

Crea un objeto SecondaryTile . A continuación, el autor de la llamada debe establecer las propiedades obligatorias a través del objeto antes de intentar anclar, actualizar o eliminar el icono.

En una aplicación de escritorio, antes de usar una instancia de esta clase de forma que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen de CoreWindow.

public:
 SecondaryTile();

 SecondaryTile();

public SecondaryTile();

function SecondaryTile()

Public Sub New ()

Comentarios

Las propiedades de icono obligatorias, como el nombre para mostrar, deben establecerse mediante llamadas a otros métodos de esta clase para poder activar el icono.

SecondaryTile(String)

Crea un objeto SecondaryTile con un identificador específico. Esta forma del constructor debe usarse para crear un objeto de icono secundario para realizar una actualización o eliminación de iconos.

En una aplicación de escritorio, antes de usar una instancia de esta clase de forma que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen 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)

Parámetros

tileId

String

Platform::String

winrt::hstring

Cadena que identificará de forma única el icono dentro de la aplicación. Elija un identificador único descriptivo y significativo para la aplicación. Si proporciona el mismo identificador que el de un icono secundario existente, se sobrescribirá el icono secundario existente.

Comentarios

El identificador único que se usa para crear este icono se puede usar más adelante para actualizarlo o eliminarlo.

Otras propiedades de icono obligatorias, como el nombre para mostrar, deben establecerse mediante llamadas a otros métodos de esta clase para poder activar el icono.

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

Crea un objeto SecondaryTile que incluye todas las propiedades obligatorias necesarias para crear un icono medio.

En una aplicación de escritorio, antes de usar una instancia de esta clase de forma que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen 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)

Parámetros

tileId

String

Platform::String

winrt::hstring

Cadena que identificará de forma única el icono dentro del paquete de la aplicación. Elija un identificador único descriptivo y significativo para la aplicación. Se limita a 64 caracteres y debe comenzar con un número o letra y estar compuesto por los caracteres a-z, A-Z, 0-9, punto (.) o subrayado (_). Si proporciona el mismo identificador que el de un icono secundario existente, se sobrescribirá el icono secundario existente. Se puede establecer o recuperar mediante la propiedad TileId .

displayName

String

Platform::String

winrt::hstring

Nombre que se va a mostrar en el icono, en la información sobre herramientas del icono y cuando se muestran iconos pequeños, como en las pantallas Aplicaciones o resultados de búsqueda. Esta cadena es equivalente al nombre para mostrar proporcionado en el manifiesto del icono principal. Está restringido a 256 caracteres, pero en la práctica debe mantenerse corto para evitar el truncamiento. Este valor se puede establecer o recuperar a través de la propiedad DisplayName .

El nombre para mostrar solo se muestra en el icono secundario ancho en Windows Phone 8.1.

arguments

String

Platform::String

winrt::hstring

Cadena definida por la aplicación significativa para la aplicación que llama. Esta cadena de argumento se devuelve a la aplicación cuando la aplicación se activa desde el icono secundario. Se truncará después de 2048 caracteres. Se puede establecer o recuperar mediante la propiedad Arguments .

Nota

Este parámetro debe estar codificado con dirección URL para Windows Phone aplicaciones de Silverlight 8.1. Todos los demás tipos de aplicaciones pueden usar su propia estructura.

square150x150Logo

Uri Uri

Referencia a una imagen de logotipo mediana almacenada en un identificador uniforme de recursos (URI). Se puede establecer o recuperar mediante la propiedad SecondaryTileVisualElements.Square150x150Logo . Este valor se puede expresar mediante uno de estos esquemas: ruta de acceso ms-appx:/// A dentro del paquete de aplicación implementado. Esta ruta de acceso se resuelve para los idiomas y la meseta de PPP compatibles con la aplicación.Archivo ms-appdata:///local/ A que se encuentra en el almacenamiento de aplicaciones por usuario.

desiredSize

TileSize

Tamaño del icono que se va a anclar. Este valor debe ser Default (que proporciona el comportamiento de Windows 8), Square150x150 o Wide310x150. Cualquier otro valor tileSize hace que se produzca una excepción durante el tiempo de ejecución.

El parámetro desiredSize se omite en Windows Phone 8.1. En el teléfono, todos los iconos (incluidos los iconos secundarios) se anclan como iconos medianos, después de los cuales el usuario puede cambiar el tamaño.

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

Nota

Este constructor puede modificarse o no estar disponible para las versiones después de Windows 8.1. En su lugar, use SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize).

Crea un objeto SecondaryTile como un icono medio.

En una aplicación de escritorio, antes de usar una instancia de esta clase de una manera que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen 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)

Parámetros

tileId

String

Platform::String

winrt::hstring

Cadena que identificará de forma única el icono dentro del paquete de la aplicación. Elija un identificador único descriptivo y significativo para la aplicación. Se limita a 64 caracteres y debe comenzar con un número o letra y estar compuesto por los caracteres a-z, A-Z, 0-9, punto (.) o subrayado (_). Si proporciona el mismo identificador que el de un icono secundario existente, se sobrescribirá el icono secundario existente. Se puede establecer o recuperar mediante la propiedad TileId .

shortName

String

Platform::String

winrt::hstring

Nombre corto que se mostrará directamente en el icono si la aplicación decide hacerlo. Se truncará cualquier cosa de más de 40 caracteres. El usuario tiene la opción de cambiar este valor como parte del proceso de anclaje. Se puede establecer o recuperar mediante la propiedad ShortName .

Nota:

Este valor solo se usa en Windows 8 y está en desuso en favor de displayName en versiones posteriores.

displayName

String

Platform::String

winrt::hstring

Nombre que se mostrará en el icono, en la información sobre herramientas del icono y al mostrar iconos pequeños, como en las pantallas Aplicaciones o resultados de búsqueda. Esta cadena es equivalente al nombre para mostrar proporcionado en el manifiesto del icono principal. Está restringido a 256 caracteres, pero en la práctica debe mantenerse corto para evitar el truncamiento. Este valor se puede establecer o recuperar mediante la propiedad DisplayName .

El nombre para mostrar solo se muestra en el icono secundario ancho de Windows Phone 8.1.

arguments

String

Platform::String

winrt::hstring

Cadena definida por la aplicación significativa para la aplicación que llama. Esta cadena de argumento se devuelve a la aplicación cuando la aplicación se activa desde el icono secundario. Se truncará después de 2048 caracteres. Se puede establecer o recuperar mediante la propiedad Arguments .

tileOptions

TileOptions

Valor que especifica varias opciones, como si el nombre se mostrará en el icono secundario. Se puede establecer o recuperar mediante la propiedad TileOptions .

logoReference

Uri Uri

Referencia a una imagen de logotipo cuadrada almacenada en un identificador uniforme de recursos (URI). Se puede establecer o recuperar mediante la propiedad Logo . Este valor se puede expresar mediante uno de estos esquemas: ruta de acceso ms-appx:/// A dentro del paquete de aplicación implementado. Esta ruta de acceso se resuelve para los idiomas y la meseta de PPP compatibles con la aplicación.Archivo ms-appdata:///local/ A que se encuentra en el almacenamiento de aplicaciones por usuario.

Atributos

DeprecatedAttribute

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

Nota

Este constructor puede modificarse o no estar disponible para las versiones después de Windows 8.1. En su lugar, use SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) y proporcione otros tamaños y opciones de icono a través del método SecondaryTile.VisualElements .

Crea un objeto SecondaryTile como un icono ancho.

En una aplicación de escritorio, antes de usar una instancia de esta clase de una manera que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen de CoreWindow.

En Windows Phone 8.1, todos los iconos (incluidos los iconos secundarios) se anclan como iconos medianos, después de los cuales el usuario puede cambiar su tamaño. Este constructor proporciona la opción de cambiar el tamaño a un icono ancho.

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)

Parámetros

tileId

String

Platform::String

winrt::hstring

Cadena que identificará de forma única el icono dentro del paquete de la aplicación. Elija un identificador único descriptivo y significativo para la aplicación. Se limita a 64 caracteres y debe comenzar con un número o letra y estar compuesto por los caracteres a-z, A-Z, 0-9, punto (.) o subrayado (_). Si proporciona el mismo identificador que el de un icono secundario existente, se sobrescribirá el icono secundario existente. Se puede establecer o recuperar mediante la propiedad TileId .

shortName

String

Platform::String

winrt::hstring

Nombre corto que se mostrará directamente en el icono si la aplicación decide hacerlo. Se truncará cualquier cosa de más de 40 caracteres. El usuario tiene la opción de cambiar este valor como parte del proceso de anclaje. Se puede establecer o recuperar mediante la propiedad ShortName .

Nota

Este valor solo se usa en Windows 8 y está en desuso en favor de displayName en versiones posteriores.

displayName

String

Platform::String

winrt::hstring

Nombre que se mostrará en el icono, en la información sobre herramientas del icono y al mostrar iconos pequeños, como en las pantallas Aplicaciones o resultados de búsqueda. Esta cadena es equivalente al nombre para mostrar proporcionado en el manifiesto del icono principal. Está restringido a 256 caracteres, pero en la práctica debe mantenerse corto para evitar el truncamiento. Este valor se puede establecer o recuperar mediante la propiedad DisplayName .

El nombre para mostrar solo se muestra en el icono secundario ancho de Windows Phone 8.1.

arguments

String

Platform::String

winrt::hstring

Cadena definida por la aplicación significativa para la aplicación que llama. Esta cadena de argumento se devuelve a la aplicación cuando la aplicación se activa desde el icono secundario. Se truncará después de 2048 caracteres. Se puede establecer o recuperar mediante la propiedad Arguments .

tileOptions

TileOptions

Valor que especifica varias opciones, como si el nombre se mostrará en el icono secundario. Se puede establecer o recuperar mediante la propiedad TileOptions .

logoReference

Uri Uri

Referencia a una imagen de logotipo medio almacenada en un identificador uniforme de recursos (URI). Se puede establecer o recuperar mediante la propiedad Square150x150Logo . Este valor se puede expresar mediante uno de estos esquemas: ruta de acceso ms-appx:/// A dentro del paquete de aplicación implementado. Esta ruta de acceso se resuelve para los idiomas y la meseta de PPP compatibles con la aplicación.Archivo ms-appdata:///local/ A que se encuentra en el almacenamiento de aplicaciones por usuario.

wideLogoReference

Uri Uri

Referencia a una imagen de logotipo ancho almacenada en un identificador uniforme de recursos (URI). Se puede establecer o recuperar mediante la propiedad WideLogo . Este valor se puede expresar mediante uno de estos esquemas: ruta de acceso ms-appx:/// A dentro del paquete de aplicación implementado. Esta ruta de acceso se resuelve para los idiomas y la meseta de PPP compatibles con la aplicación.Archivo ms-appdata:///local/ A que se encuentra en el almacenamiento de aplicaciones por usuario.

Atributos

DeprecatedAttribute