SecondaryTile.RequestCreateAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
RequestCreateAsync() |
사용자가 보조 타일 을 만들 것인지 확인할 수 있는 시작 화면에 고정 플라이아웃을 표시합니다. 그러면 타일이 만들어집니다. 이 메서드의 오버로드를 사용하면 플라이아웃의 화면 위치를 지정할 수 있습니다. 참고 타일 만들기 요청을 호출한 단추 근처에 시작 화면에 고정 플라이아웃을 표시하는 것이 가장 좋습니다. 따라서 이 메서드 오버로드의 RequestCreateAsync(Point) 형식을 사용하는 것이 좋습니다.
|
RequestCreateAsync(Point) |
사용자가 보조 타일 을 만들 것인지 확인할 수 있는 지정된 위치 위에 시작 화면에 고정 플라이아웃을 표시합니다. 그러면 타일이 만들어집니다.
|
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
시작 플라이아웃에 고정의 오른쪽 아래 모서리 로 사용되는 점입니다.
반환
비동기 만들기 작업에 관한 정보를 제공하는 개체입니다.
- 특성