SecondaryTile.RequestCreateAsync Метод

Определение

Пространство имен:

Windows.UI.StartScreen

Перегрузки

RequestCreateAsync()

Отображает всплывающее окно Закрепить на начальном экране , с помощью которого пользователь может подтвердить, что он хочет создать вторичную плитку, которая, в свою очередь, создает плитку. Перегрузки этого метода позволяют указать расположение всплывающего элемента на экране. Примечание Рекомендуется отображать всплывающий элемент Закрепить на начальном экране рядом с кнопкой, которая вызвала запрос на создание плитки. Поэтому рекомендуется использовать форму RequestCreateAsync(Point) перегрузки этого метода. В Windows Phone 8.1 вторичная плитка создается с помощью этого вызова, не отображая всплывающее окно пользователя, не запрашивая подтверждение или не позволяя выбрать размер плитки или текст заголовка. Обратите внимание, что при использовании метода RequestCreateAsync для закрепления дополнительной плитки в приложении Windows Phone версии 8.x приложение приостанавливается, а пользователь перейдет на начальный экран. Этот же вызов API на компьютере не приостанавливает работу программы. Поэтому имейте в виду, что любой код, вызываемый после RequestCreateAsync, не гарантируется для выполнения до приостановки приложения. Чтобы избежать этой потенциальной проблемы, следует использовать событие OnSuspended приложения для выполнения любого кода, например обновления закрепленной плитки, который должен быть запущен до приостановки приложения. Чтобы просмотреть пример этого шаблона, скачайте и запустите пример обновления плитки при приостановке.

RequestCreateAsync(Point)

Отображает всплывающее окно Закрепить на начальном экране над указанным расположением, с помощью которого пользователь может подтвердить, что он хочет создать вспомогательную плитку, которая, в свою очередь, создает плитку. В Windows Phone 8.1 вторичная плитка создается с помощью этого вызова, не отображая всплывающее окно пользователя, не запрашивая подтверждение или не позволяя выбрать размер плитки или текст заголовка. Обратите внимание, что при использовании метода RequestCreateAsync для закрепления дополнительной плитки в приложении Windows Phone 8.x приложение приостанавливается, а пользователь перейдет на начальный экран. Этот же вызов API на компьютере не приостанавливает работу программы. Поэтому имейте в виду, что любой код, вызываемый после RequestCreateAsync , не гарантируется для выполнения до приостановки приложения. Чтобы избежать этой потенциальной проблемы, следует использовать событие OnSuspended приложения для выполнения любого кода, например обновления закрепленной плитки, который должен быть запущен до приостановки приложения. Чтобы просмотреть пример этого шаблона, скачайте и запустите пример обновления плитки при приостановке.

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

IAsyncOperation<bool>

Объект, используемый для запуска асинхронной операции создания, а также для получения сведений о ней.

Атрибуты

OverloadAttribute

Комментарии

После создания дополнительной плитки необходимо указать следующие свойства перед ее отображением:

• tileId
• displayName
• Аргументы
• SecondaryTileVisualElements.Square150x150Logo

Этот метод возвращает асинхронное логическое значение через объект 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

Точка, используемая в качестве правого нижнего угла всплывающего окна Закрепить на начальном экране .

Возвращаемое значение

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Объект , предоставляющий сведения об асинхронной операции создания.

Атрибуты

OverloadAttribute