SecondaryTile.RequestCreateAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| RequestCreateAsync() |
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. Nota Se recomienda mostrar el control flotante Anclar a inicio cerca del botón que invocó la solicitud para crear el icono. Por lo tanto, se recomienda usar el formulario RequestCreateAsync(Point) de esta sobrecarga de método.
|
| RequestCreateAsync(Point) |
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.
|
RequestCreateAsync()
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.
Nota:
Se recomienda mostrar el control flotante Anclar a inicio cerca del botón que invocó la solicitud para crear el icono. Por lo tanto, se recomienda usar el formulario RequestCreateAsync(Point) de esta sobrecarga de método.
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.
public:
virtual IAsyncOperation<bool> ^ RequestCreateAsync() = RequestCreateAsync;/// [Windows.Foundation.Metadata.Overload("RequestCreateAsync")]
IAsyncOperation<bool> RequestCreateAsync();[Windows.Foundation.Metadata.Overload("RequestCreateAsync")]
public IAsyncOperation<bool> RequestCreateAsync();function requestCreateAsync()Public Function RequestCreateAsync () As IAsyncOperation(Of Boolean)Devoluciones
Objeto que se usa para iniciar la operación de creación asincrónica, así como para recuperar información sobre ella.
- Atributos
Comentarios
Una vez creado un icono secundario, debe proporcionar las siguientes propiedades antes de que se muestren:
Este método devuelve un valor booleano asincrónico a través de su objeto IAsyncOperation como se muestra aquí. Un valor true indica que el icono secundario se ha creado y anclado a la pantalla Inicio.
async void showTileCreateRequest( SecondaryTile tile )
{
bool isPinned = await tile.requestCreateAsync();
}
Se aplica a
RequestCreateAsync(Point)
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.
public:
virtual IAsyncOperation<bool> ^ RequestCreateAsync(Point invocationPoint) = RequestCreateAsync;/// [Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithPoint")]
IAsyncOperation<bool> RequestCreateAsync(Point const& invocationPoint);[Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithPoint")]
public IAsyncOperation<bool> RequestCreateAsync(Point invocationPoint);function requestCreateAsync(invocationPoint)Public Function RequestCreateAsync (invocationPoint As Point) As IAsyncOperation(Of Boolean)Parámetros
- invocationPoint
- Point
Punto usado como esquina inferior derecha del control flotante Anclar a inicio .
Devoluciones
Objeto que proporciona información sobre la operación de creación asincrónica.
- Atributos