SecondaryTile.RequestCreateForSelectionAsync 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
| RequestCreateForSelectionAsync(Rect) |
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.
|
| RequestCreateForSelectionAsync(Rect, Placement) |
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.
|
RequestCreateForSelectionAsync(Rect)
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.
public:
virtual IAsyncOperation<bool> ^ RequestCreateForSelectionAsync(Rect selection) = RequestCreateForSelectionAsync;/// [Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithRect")]
IAsyncOperation<bool> RequestCreateForSelectionAsync(Rect const& selection);[Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithRect")]
public IAsyncOperation<bool> RequestCreateForSelectionAsync(Rect selection);function requestCreateForSelectionAsync(selection)Public Function RequestCreateForSelectionAsync (selection As Rect) As IAsyncOperation(Of Boolean)Parámetros
- selection
- Rect
El área en la que se muestra el control flotante directamente encima.
Devoluciones
Objeto que proporciona información sobre la operación de creación asincrónica.
- Atributos
Comentarios
Después de crear un icono secundario, debe proporcionar las siguientes propiedades antes de que se muestre:
Se aplica a
RequestCreateForSelectionAsync(Rect, Placement)
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.
public:
virtual IAsyncOperation<bool> ^ RequestCreateForSelectionAsync(Rect selection, Placement preferredPlacement) = RequestCreateForSelectionAsync;/// [Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithRectAndPlacement")]
IAsyncOperation<bool> RequestCreateForSelectionAsync(Rect const& selection, Placement const& preferredPlacement);[Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithRectAndPlacement")]
public IAsyncOperation<bool> RequestCreateForSelectionAsync(Rect selection, Placement preferredPlacement);function requestCreateForSelectionAsync(selection, preferredPlacement)Public Function RequestCreateForSelectionAsync (selection As Rect, preferredPlacement As Placement) As IAsyncOperation(Of Boolean)Parámetros
- selection
- Rect
Área a un lado del que se mostrará el control flotante.
- preferredPlacement
- Placement
Lado del rectángulo donde debe aparecer el control flotante.
Devoluciones
Objeto que proporciona información sobre la operación de creación asincrónica.
- Atributos