SecondaryTile.RequestCreateForSelectionAsync Метод

Определение

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

Windows.UI.StartScreen

Перегрузки

RequestCreateForSelectionAsync(Rect)

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

RequestCreateForSelectionAsync(Rect, Placement)

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

RequestCreateForSelectionAsync(Rect)

Отображает всплывающий элемент Закрепить на начальном экране над указанной областью. Этот всплывающий элемент используется пользователем для подтверждения того, что он хочет создать вспомогательную плитку, которая, в свою очередь, создает плитку.

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

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)

Параметры

selection

Rect

Область, над которым отображается всплывающее меню.

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

IAsyncOperation<Boolean>

IAsyncOperation<bool>

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

Атрибуты

OverloadAttribute

Комментарии

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

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

RequestCreateForSelectionAsync(Rect, Placement)

Отображает всплывающий элемент Закрепить на начальном экране на указанной стороне указанной области. Этот всплывающий элемент используется пользователем для подтверждения того, что он хочет создать вспомогательную плитку, которая, в свою очередь, создает плитку.

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

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)

Параметры

selection

Rect

Область, на стороне которой будет отображаться всплывающее меню.

preferredPlacement

Placement

Сторона прямоугольника, где должен появиться всплывающий элемент.

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

IAsyncOperation<Boolean>

IAsyncOperation<bool>

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

Атрибуты

OverloadAttribute