SecondaryTile.RequestCreateAsync 메서드

  • 참조

정의

네임스페이스:
Windows.UI.StartScreen

오버로드

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

IAsyncOperation<bool>

비동기 만들기 작업을 시작하고 해당 개체에 대한 정보를 검색하는 데 사용되는 개체입니다.

특성
OverloadAttribute

설명

보조 타일을 만든 후 표시되기 전에 다음 속성을 제공해야 합니다.

이 메서드는 여기에 표시된 대로 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

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

반환

IAsyncOperation<Boolean>

IAsyncOperation<bool>

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

특성
OverloadAttribute

적용 대상