다음을 통해 공유


SecondaryTile.RequestCreateAsync 메서드

정의

오버로드

RequestCreateAsync()

사용자가 보조 타일 을 만들 것인지 확인할 수 있는 시작 화면에 고정 플라이아웃을 표시합니다. 그러면 타일이 만들어집니다. 이 메서드의 오버로드를 사용하면 플라이아웃의 화면 위치를 지정할 수 있습니다.

참고

타일 만들기 요청을 호출한 단추 근처에 시작 화면에 고정 플라이아웃을 표시하는 것이 가장 좋습니다. 따라서 이 메서드 오버로드의 RequestCreateAsync(Point) 형식을 사용하는 것이 좋습니다.

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

RequestCreateAsync(Point)

사용자가 보조 타일 을 만들 것인지 확인할 수 있는 지정된 위치 위에 시작 화면에 고정 플라이아웃을 표시합니다. 그러면 타일이 만들어집니다.

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

RequestCreateAsync()

사용자가 보조 타일 을 만들 것인지 확인할 수 있는 시작 화면에 고정 플라이아웃을 표시합니다. 그러면 타일이 만들어집니다. 이 메서드의 오버로드를 사용하면 플라이아웃의 화면 위치를 지정할 수 있습니다.

참고

타일 만들기 요청을 호출한 단추 근처에 시작 화면에 고정 플라이아웃을 표시하는 것이 가장 좋습니다. 따라서 이 메서드 오버로드의 RequestCreateAsync(Point) 형식을 사용하는 것이 좋습니다.

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

시작 플라이아웃에 고정의 오른쪽 아래 모서리 사용되는 점입니다.

반환

비동기 만들기 작업에 관한 정보를 제공하는 개체입니다.

특성

적용 대상