SecondaryTile.RequestCreateAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| RequestCreateAsync() |
Отображает всплывающее окно Закрепить на начальном экране , с помощью которого пользователь может подтвердить, что он хочет создать вторичную плитку, которая, в свою очередь, создает плитку. Перегрузки этого метода позволяют указать расположение всплывающего элемента на экране. Примечание Рекомендуется отображать всплывающий элемент Закрепить на начальном экране рядом с кнопкой, которая вызвала запрос на создание плитки. Поэтому рекомендуется использовать форму RequestCreateAsync(Point) перегрузки этого метода.
|
| RequestCreateAsync(Point) |
Отображает всплывающее окно Закрепить на начальном экране над указанным расположением, с помощью которого пользователь может подтвердить, что он хочет создать вспомогательную плитку, которая, в свою очередь, создает плитку.
|
RequestCreateAsync()
Отображает всплывающее окно Закрепить на начальном экране , с помощью которого пользователь может подтвердить, что он хочет создать вторичную плитку, которая, в свою очередь, создает плитку. Перегрузки этого метода позволяют указать расположение всплывающего элемента на экране.
Примечание
Рекомендуется отображать всплывающий элемент Закрепить на начальном экране рядом с кнопкой, которая вызвала запрос на создание плитки. Поэтому рекомендуется использовать форму RequestCreateAsync(Point) перегрузки этого метода.
В Windows Phone 8.1 вторичная плитка создается с помощью этого вызова, не отображая всплывающее окно пользователя, не запрашивая подтверждение или не позволяя выбрать размер плитки или текст заголовка. Обратите внимание, что при использовании метода RequestCreateAsync для закрепления дополнительной плитки в приложении Windows Phone версии 8.x приложение приостанавливается, а пользователь перейдет на начальный экран. Этот же вызов API на компьютере не приостанавливает работу программы. Поэтому имейте в виду, что любой код, вызываемый после RequestCreateAsync, не гарантируется для выполнения до приостановки приложения. Чтобы избежать этой потенциальной проблемы, следует использовать событие OnSuspended приложения для выполнения любого кода, например обновления закрепленной плитки, который должен быть запущен до приостановки приложения. Чтобы просмотреть пример этого шаблона, скачайте и запустите пример обновления плитки при приостановке.
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)Возвращаемое значение
Объект, используемый для запуска асинхронной операции создания, а также для получения сведений о ней.
- Атрибуты
Комментарии
После создания дополнительной плитки необходимо указать следующие свойства перед ее отображением:
Этот метод возвращает асинхронное логическое значение через объект IAsyncOperation , как показано здесь. Значение true указывает, что вспомогательная плитка была создана и закреплена на начальном экране.
async void showTileCreateRequest( SecondaryTile tile )
{
bool isPinned = await tile.requestCreateAsync();
}
Применяется к
RequestCreateAsync(Point)
Отображает всплывающее окно Закрепить на начальном экране над указанным расположением, с помощью которого пользователь может подтвердить, что он хочет создать вспомогательную плитку, которая, в свою очередь, создает плитку.
В Windows Phone 8.1 вторичная плитка создается с помощью этого вызова, не отображая всплывающее окно пользователя, не запрашивая подтверждение или не позволяя выбрать размер плитки или текст заголовка. Обратите внимание, что при использовании метода RequestCreateAsync для закрепления дополнительной плитки в приложении Windows Phone 8.x приложение приостанавливается, а пользователь перейдет на начальный экран. Этот же вызов API на компьютере не приостанавливает работу программы. Поэтому имейте в виду, что любой код, вызываемый после RequestCreateAsync , не гарантируется для выполнения до приостановки приложения. Чтобы избежать этой потенциальной проблемы, следует использовать событие OnSuspended приложения для выполнения любого кода, например обновления закрепленной плитки, который должен быть запущен до приостановки приложения. Чтобы просмотреть пример этого шаблона, скачайте и запустите пример обновления плитки при приостановке.
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)Параметры
- invocationPoint
- Point
Точка, используемая в качестве правого нижнего угла всплывающего окна Закрепить на начальном экране .
Возвращаемое значение
Объект , предоставляющий сведения об асинхронной операции создания.
- Атрибуты