SecondaryTile.RequestCreateForSelectionAsync SecondaryTile.RequestCreateForSelectionAsync SecondaryTile.RequestCreateForSelectionAsync SecondaryTile.RequestCreateForSelectionAsync SecondaryTile.RequestCreateForSelectionAsync Method

Definition

Overloads

RequestCreateForSelectionAsync(Rect) RequestCreateForSelectionAsync(Rect) RequestCreateForSelectionAsync(Rect) RequestCreateForSelectionAsync(Rect) RequestCreateForSelectionAsync(Rect)

Displays the Pin to Start flyout above a specified area. This flyout is used by the user to confirm that they want to create the secondary tile, which in turn creates the tile.

On Windows Phone 8.1, the secondary tile is created through this call without showing the user a flyout, prompting them for confirmation, or allowing them to choose a tile size or title text. Note that when using the RequestCreateAsync method to pin a secondary tile in Windows Phone 8.x app, the app is suspended and the user is taken to the Start screen. This same API call on a PC does not suspend the program. Therefore, be aware that any code called after RequestCreateAsync is not guaranteed to be run before the app is suspended. To avoid this potential issue you should use the OnSuspended event of your app to run any code, such as updating the pinned tile, that should be run before the app suspends. To see an example of this pattern, download and run the Tile update on suspend sample.

RequestCreateForSelectionAsync(Rect, Placement) RequestCreateForSelectionAsync(Rect, Placement) RequestCreateForSelectionAsync(Rect, Placement) RequestCreateForSelectionAsync(Rect, Placement) RequestCreateForSelectionAsync(Rect, Placement)

Displays the Pin to Start flyout at the specified side of a specified area. This flyout is used by the user to confirm that they want to create the secondary tile, which in turn creates the tile.

On Windows Phone 8.1, the secondary tile is created through this call without showing the user a flyout, prompting them for confirmation, or allowing them to choose a tile size or title text. Note that when using the RequestCreateAsync method to pin a secondary tile in Windows Phone 8.x app, the app is suspended and the user is taken to the Start screen. This same API call on a PC does not suspend the program. Therefore, be aware that any code called after RequestCreateAsync is not guaranteed to be run before the app is suspended. To avoid this potential issue you should use the OnSuspended event of your app to run any code, such as updating the pinned tile, that should be run before the app suspends. To see an example of this pattern, download and run the Tile update on suspend sample.

RequestCreateForSelectionAsync(Rect) RequestCreateForSelectionAsync(Rect) RequestCreateForSelectionAsync(Rect) RequestCreateForSelectionAsync(Rect) RequestCreateForSelectionAsync(Rect)

Displays the Pin to Start flyout above a specified area. This flyout is used by the user to confirm that they want to create the secondary tile, which in turn creates the tile.

On Windows Phone 8.1, the secondary tile is created through this call without showing the user a flyout, prompting them for confirmation, or allowing them to choose a tile size or title text. Note that when using the RequestCreateAsync method to pin a secondary tile in Windows Phone 8.x app, the app is suspended and the user is taken to the Start screen. This same API call on a PC does not suspend the program. Therefore, be aware that any code called after RequestCreateAsync is not guaranteed to be run before the app is suspended. To avoid this potential issue you should use the OnSuspended event of your app to run any code, such as updating the pinned tile, that should be run before the app suspends. To see an example of this pattern, download and run the Tile update on suspend sample.

public : IAsyncOperation<Platform::Boolean> RequestCreateForSelectionAsync(Rect selection)
IAsyncOperation<bool> RequestCreateForSelectionAsync(Rect selection) const;
public IAsyncOperation<bool> RequestCreateForSelectionAsync(Rect selection)
Public Function RequestCreateForSelectionAsync(selection As Rect) As IAsyncOperation(Of bool)
Windows.UI.StartScreen.SecondaryTile.requestCreateForSelectionAsync(selection).done( /* Your success and error handlers */ );

Parameters

selection
Rect Rect Rect

The area that the flyout is displayed directly above.

Returns

An object that provides information concerning the asynchronous create operation.

Remarks

After a secondary tile is created, you must provide the following properties before it is displayed:

RequestCreateForSelectionAsync(Rect, Placement) RequestCreateForSelectionAsync(Rect, Placement) RequestCreateForSelectionAsync(Rect, Placement) RequestCreateForSelectionAsync(Rect, Placement) RequestCreateForSelectionAsync(Rect, Placement)

Displays the Pin to Start flyout at the specified side of a specified area. This flyout is used by the user to confirm that they want to create the secondary tile, which in turn creates the tile.

On Windows Phone 8.1, the secondary tile is created through this call without showing the user a flyout, prompting them for confirmation, or allowing them to choose a tile size or title text. Note that when using the RequestCreateAsync method to pin a secondary tile in Windows Phone 8.x app, the app is suspended and the user is taken to the Start screen. This same API call on a PC does not suspend the program. Therefore, be aware that any code called after RequestCreateAsync is not guaranteed to be run before the app is suspended. To avoid this potential issue you should use the OnSuspended event of your app to run any code, such as updating the pinned tile, that should be run before the app suspends. To see an example of this pattern, download and run the Tile update on suspend sample.

public : IAsyncOperation<Platform::Boolean> RequestCreateForSelectionAsync(Rect selection, Placement preferredPlacement)
IAsyncOperation<bool> RequestCreateForSelectionAsync(Rect selection, Placement preferredPlacement) const;
public IAsyncOperation<bool> RequestCreateForSelectionAsync(Rect selection, Placement preferredPlacement)
Public Function RequestCreateForSelectionAsync(selection As Rect, preferredPlacement As Placement) As IAsyncOperation(Of bool)
Windows.UI.StartScreen.SecondaryTile.requestCreateForSelectionAsync(selection, preferredPlacement).done( /* Your success and error handlers */ );

Parameters

selection
Rect Rect Rect

The area to one side of which the flyout will be displayed.

preferredPlacement
Placement Placement Placement

The side of the rectangle where the flyout should appear.

Returns

An object that provides information concerning the asynchronous create operation.