SecondaryTile Clase

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 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.

Crea un objeto SecondaryTile con un identificador específico. Este formato 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 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.

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.

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.

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 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.

Obtiene o establece un conjunto de información definido por la aplicación que se pasa desde el icono secundario a la aplicación durante la activación. Esta propiedad es necesaria al crear un icono.

Obtiene o establece el color de fondo del icono.

Obtiene o establece un nombre asociado a y que se muestra en el icono. Este nombre se muestra en el icono de Inicio, en la información sobre herramientas del icono, junto a la representación de icono pequeña en la lista Aplicaciones y en algunas aplicaciones Panel de control. Esta propiedad es necesaria al crear un icono. Es el equivalente del nombre para mostrar declarado en el manifiesto para el icono principal de la aplicación.

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

Obtiene o establece si el icono debe usar texto oscuro o claro.

Obtiene o establece la ubicación de una imagen de logotipo de distintivo para representar el icono secundario en la pantalla de bloqueo. Al proporcionar esta imagen, declara que el icono secundario es apto para mostrar un distintivo en la pantalla de bloqueo. Si también desea que el icono secundario sea apto para la ranura de mosaico detallada de la pantalla de bloqueo, también debe establecer la propiedad LockScreenDisplayBadgeAndTileText en True.

Obtiene o establece si el icono secundario es apto para mostrar un distintivo y un icono detallado en la pantalla de bloqueo. Si establece esta propiedad en True, también debe proporcionar una imagen de distintivo a través de la propiedad LockScreenBadgeLogo . Si no desea usar la funcionalidad detallada del icono, proporcione una imagen de distintivo a través de la propiedad LockScreenBadgeLogo y establezca LockScreenDisplayBadgeAndTileText en False.

Obtiene o establece la imagen de logotipo usada en un icono medio. Esta propiedad es necesaria cuando se crea un cuadrado o un icono ancho.

Obtiene o establece una versión fonética del nombre del icono secundario. Se usa con lenguajes basados en caracteres con fines de ordenación de la interfaz de usuario.

Obtiene o establece un valor que determina si el icono secundario se volverá a adquirir a través de la nube cuando el usuario instale la aplicación primaria, con su cuenta Microsoft, en otro equipo. Tenga en cuenta que a partir de Windows 8.1, la itinerancia es el comportamiento predeterminado. Esto es lo contrario al comportamiento predeterminado de Windows 8, donde la itinerancia era opcional.

Esta propiedad siempre devuelve false en Windows Phone 8.1.

Obtiene o establece un nombre corto que se mostrará directamente en el icono.

Obtiene o establece la imagen de logotipo pequeña, usada en los resultados de búsqueda, la lista Todos los programas y otras ubicaciones de la interfaz de usuario.

El logotipo pequeño no se usa con un icono secundario de Windows Phone 8.1.

Obtiene o establece una cadena única para identificar el icono dentro del paquete. Esta propiedad es necesaria al crear o eliminar un icono.

Obtiene o establece las opciones disponibles para un icono secundario.

Obtiene un objeto a través del cual puede obtener o establecer el color de fondo de un icono secundario, el texto en primer plano, las imágenes de mosaico y las opciones para mostrar del nombre de la aplicación. A partir de Windows 8.1, las propiedades de este objeto reemplazan estas propiedades SecondaryTile:

• SecondaryTile.BackgroundColor
• SecondaryTile.ForegroundText
• SecondaryTile.Logo
• SecondaryTile.SmallLogo
• SecondaryTile.WideLogo
• SecondaryTile.TileOptions (excepto CopyOnDeployment)

Obtiene o establece la imagen de logotipo usada en un icono secundario ancho. Esta propiedad es necesaria cuando se crea un icono secundario ancho y se proporciona al usuario la opción de un icono ancho cuando cambia el tamaño del icono.

Comprueba si existe un icono secundario específico para la aplicación que realiza la llamada.

Recupera una lista de iconos secundarios creados para la aplicación que llama.

Recupera una lista de iconos secundarios creados para otra aplicación en el mismo paquete que la aplicación que llama.

Recupera una lista de iconos secundarios creados para todas las aplicaciones del paquete de la aplicación que llama.

Cuando se inicia una aplicación, siempre debe enumerar sus iconos secundarios a través de este método, en caso de que haya adiciones o eliminaciones de las que no era consciente. Cuando se elimina un icono secundario a través de la barra de la aplicación Pantalla de inicio, Windows simplemente quita el icono. La propia aplicación es responsable de liberar los recursos usados por el icono secundario. Cuando los iconos secundarios se copian a través de la nube, las notificaciones de icono o distintivo actuales en el icono secundario, las notificaciones programadas, los canales de notificación push y el identificador uniforme de recursos (URI) usados con las notificaciones periódicas no se copian con el icono secundario y deben restablecerse.

Muestra el control flotante Anclar a inicio , a través del cual el usuario puede confirmar que desea crear el icono secundario, que a su vez crea el icono. Las sobrecargas de este método permiten especificar la ubicación en pantalla del control flotante.

En Windows Phone 8.1, el icono secundario se crea a través de esta llamada sin mostrar al usuario un control flotante, pedirle confirmación o permitirle elegir un tamaño de icono o texto de título. Tenga en cuenta que al usar el método RequestCreateAsync para anclar un icono secundario en Windows Phone aplicación 8.x, la aplicación se suspende y el usuario se lleva a la pantalla Inicio. Esta misma llamada API en un equipo no suspende el programa. Por lo tanto, tenga en cuenta que no se garantiza que se ejecute ningún código llamado después de RequestCreateAsync antes de que se suspenda la aplicación. Para evitar este posible problema, debes usar el evento OnSuspended de la aplicación para ejecutar cualquier código, como actualizar el icono anclado, que debe ejecutarse antes de que se suspenda la aplicación. Para ver un ejemplo de este patrón, descargue y ejecute la actualización del icono en el ejemplo de suspensión.

Muestra el control flotante Anclar a inicio encima de una ubicación especificada, a través de la cual el usuario puede confirmar que desea crear el icono secundario, que a su vez crea el icono.

En Windows Phone 8.1, el icono secundario se crea a través de esta llamada sin mostrar al usuario un control flotante, pedirle confirmación o permitirle elegir un tamaño de icono o texto de título. Tenga en cuenta que al usar el método RequestCreateAsync para anclar un icono secundario en Windows Phone aplicación 8.x, la aplicación se suspende y el usuario se lleva a la pantalla Inicio. Esta misma llamada API en un equipo no suspende el programa. Por lo tanto, tenga en cuenta que no se garantiza que se ejecute ningún código llamado después de RequestCreateAsync antes de que se suspenda la aplicación. Para evitar este posible problema, debes usar el evento OnSuspended de la aplicación para ejecutar cualquier código, como actualizar el icono anclado, que debe ejecutarse antes de que se suspenda la aplicación. Para ver un ejemplo de este patrón, descargue y ejecute la actualización del icono en el ejemplo de suspensión.

Muestra el control flotante Anclar a Inicio encima de un área especificada. El usuario usa este control flotante para confirmar que desea crear el icono secundario, que a su vez crea el icono.

En Windows Phone 8.1, el icono secundario se crea a través de esta llamada sin mostrar al usuario un control flotante, solicitarles confirmación o permitirle elegir un tamaño de icono o texto de título. Tenga en cuenta que al usar el método RequestCreateAsync para anclar un icono secundario en Windows Phone aplicación 8.x, la aplicación se suspende y el usuario se lleva a la pantalla Inicio. Esta misma llamada API en un equipo no suspende el programa. Por lo tanto, tenga en cuenta que cualquier código al que se llama después de RequestCreateAsync no se garantiza que se ejecute antes de que se suspenda la aplicación. Para evitar este posible problema, debes usar el evento OnSuspended de la aplicación para ejecutar cualquier código, como actualizar el icono anclado, que debe ejecutarse antes de que se suspenda la aplicación. Para ver un ejemplo de este patrón, descargue y ejecute la actualización de icono en el ejemplo de suspensión.

Muestra el control flotante Anclar a Inicio en el lado especificado de un área especificada. El usuario usa este control flotante para confirmar que desea crear el icono secundario, que a su vez crea el icono.

En Windows Phone 8.1, el icono secundario se crea a través de esta llamada sin mostrar al usuario un control flotante, solicitarles confirmación o permitirle elegir un tamaño de icono o texto de título. Tenga en cuenta que al usar el método RequestCreateAsync para anclar un icono secundario en Windows Phone aplicación 8.x, la aplicación se suspende y el usuario se lleva a la pantalla Inicio. Esta misma llamada API en un equipo no suspende el programa. Por lo tanto, tenga en cuenta que cualquier código al que se llama después de RequestCreateAsync no se garantiza que se ejecute antes de que se suspenda la aplicación. Para evitar este posible problema, debes usar el evento OnSuspended de la aplicación para ejecutar cualquier código, como actualizar el icono anclado, que debe ejecutarse antes de que se suspenda la aplicación. Para ver un ejemplo de este patrón, descargue y ejecute la actualización de icono en el ejemplo de suspensión.

Muestra el control flotante Desanclar desde Inicio . Este control flotante permite al usuario confirmar la eliminación del icono secundario.

Muestra el control flotante Desanclar desde Inicio en un punto especificado. Este control flotante permite al usuario confirmar la eliminación del icono secundario.

Muestra el control flotante Desanclar desde Inicio encima de un área especificada. Este control flotante permite al usuario confirmar la eliminación del icono secundario.

Muestra el control flotante Desanclar desde Inicio en el lado especificado de un área especificada. Este control flotante permite al usuario confirmar la eliminación del icono secundario.

Novedades un icono secundario después de que el icono esté anclado a la pantalla Inicio.

En Windows Phone 8.1, la aplicación se suspende y el usuario se lleva a la pantalla Inicio cuando se ancla un icono secundario. Por lo tanto, tenga en cuenta que cualquier código al que se llama después de RequestCreateAsync no se garantiza que se ejecute antes de que se suspenda la aplicación. Para evitar este posible problema, debes usar el evento OnSuspended de la aplicación para ejecutar cualquier código, como actualizar el icono anclado, que debe ejecutarse antes de que se suspenda la aplicación. Para ver un ejemplo de este patrón, descargue y ejecute la actualización de icono en el ejemplo de suspensión.

Se desencadena cuando se realiza una llamada a RequestCreateAsync.

Este evento no se genera en Windows Phone 8.1.