SecondaryTile.RequestCreateForSelectionAsync 메서드

정의

네임스페이스:

Windows.UI.StartScreen

오버로드

RequestCreateForSelectionAsync(Rect)

지정된 영역 위에 시작 화면에 고정 플라이아웃을 표시합니다. 이 플라이아웃은 사용자가 보조 타일을 만들 것인지 확인하는 데 사용되며, 그러면 타일이 만들어집니다. Windows Phone 8.1에서는 사용자에게 플라이아웃을 표시하거나 확인을 요청하거나 타일 크기 또는 제목 텍스트를 선택할 수 있도록 허용하지 않고 이 호출을 통해 보조 타일을 만듭니다. RequestCreateAsync 메서드를 사용하여 Windows Phone 8.x 앱에서 보조 타일을 고정하는 경우 앱이 일시 중단되고 사용자가 시작 화면으로 이동됩니다. PC에서 이 동일한 API 호출은 프로그램을 일시 중단하지 않습니다. 따라서 RequestCreateAsync 이후에 호출된 코드는 앱이 일시 중단되기 전에 실행되도록 보장되지 않습니다. 이 잠재적인 문제를 방지하려면 앱의 OnSuspended 이벤트를 사용하여 앱이 일시 중단되기 전에 실행해야 하는 고정된 타일 업데이트와 같은 코드를 실행해야 합니다. 이 패턴의 예를 보려면 일시 중단 샘플에서 타일 업데이트를 다운로드하여 실행합니다.

RequestCreateForSelectionAsync(Rect, Placement)

지정된 영역의 지정된 쪽에 시작 화면에 고정 플라이아웃을 표시합니다. 이 플라이아웃은 사용자가 보조 타일을 만들 것인지 확인하는 데 사용되며, 그러면 타일이 만들어집니다. Windows Phone 8.1에서는 사용자에게 플라이아웃을 표시하거나 확인을 요청하거나 타일 크기 또는 제목 텍스트를 선택할 수 있도록 허용하지 않고 이 호출을 통해 보조 타일을 만듭니다. RequestCreateAsync 메서드를 사용하여 Windows Phone 8.x 앱에서 보조 타일을 고정하는 경우 앱이 일시 중단되고 사용자가 시작 화면으로 이동됩니다. PC에서 이 동일한 API 호출은 프로그램을 일시 중단하지 않습니다. 따라서 RequestCreateAsync 이후에 호출된 코드는 앱이 일시 중단되기 전에 실행되도록 보장되지 않습니다. 이 잠재적인 문제를 방지하려면 앱의 OnSuspended 이벤트를 사용하여 앱이 일시 중단되기 전에 실행해야 하는 고정된 타일 업데이트와 같은 코드를 실행해야 합니다. 이 패턴의 예를 보려면 일시 중단 샘플에서 타일 업데이트를 다운로드하여 실행합니다.

RequestCreateForSelectionAsync(Rect)

지정된 영역 위에 시작 화면에 고정 플라이아웃을 표시합니다. 이 플라이아웃은 사용자가 보조 타일을 만들 것인지 확인하는 데 사용되며, 그러면 타일이 만들어집니다.

Windows Phone 8.1에서는 사용자에게 플라이아웃을 표시하거나 확인을 요청하거나 타일 크기 또는 제목 텍스트를 선택할 수 있도록 허용하지 않고 이 호출을 통해 보조 타일을 만듭니다. RequestCreateAsync 메서드를 사용하여 Windows Phone 8.x 앱에서 보조 타일을 고정하는 경우 앱이 일시 중단되고 사용자가 시작 화면으로 이동됩니다. PC에서 이 동일한 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 앱에서 보조 타일을 고정하는 경우 앱이 일시 중단되고 사용자가 시작 화면으로 이동됩니다. PC에서 이 동일한 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