SecondaryTile 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
보조 타일에 대한 정보를 만들고 열거하고 제공합니다.
데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시 및 데스크톱 앱에서 보조 타일 고정을 참조하세요.
public ref class SecondaryTile sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory2, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class SecondaryTile final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory2, 65536, "Windows.Foundation.UniversalApiContract")]
class SecondaryTile final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory2, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SecondaryTile final
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory2), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class SecondaryTile
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory2), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class SecondaryTile
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory2), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SecondaryTile
function SecondaryTile(tileId, shortName, displayName, arguments, tileOptions, logoReference, wideLogoReference)
Public NotInheritable Class SecondaryTile
- 상속
- 특성
Windows 요구 사항
디바이스 패밀리 |
Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox에서 도입되었습니다.)
|
API contract |
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
|
예제
다음 예제에서는 보조 타일을 만들고 시작 화면에 고정합니다.
using Windows.UI.StartScreen;
// Prepare package images for all four tile sizes in our tile to be pinned as well as for the square30x30 logo used in the Apps view.
Uri square150x150Logo = new Uri("ms-appx:///Assets/square150x150Tile-sdk.png");
Uri wide310x150Logo = new Uri("ms-appx:///Assets/wide310x150Tile-sdk.png");
Uri square310x310Logo = new Uri("ms-appx:///Assets/square310x310Tile-sdk.png");
Uri square30x30Logo = new Uri("ms-appx:///Assets/square30x30Tile-sdk.png");
// During creation of secondary tile, an application may set additional arguments on the tile that will be passed in during activation.
// These arguments should be meaningful to the application. In this sample, we'll pass in the date and time the secondary tile was pinned.
string tileActivationArguments = MainPage.logoSecondaryTileId + " WasPinnedAt=" + DateTime.Now.ToLocalTime().ToString();
// Create a Secondary tile with all the required arguments.
// Note the last argument specifies what size the Secondary tile should show up as by default in the Pin to start fly out.
// It can be set to TileSize.Square150x150, TileSize.Wide310x150, or TileSize.Default.
// If set to TileSize.Wide310x150, then the asset for the wide size must be supplied as well.
// TileSize.Default will default to the wide size if a wide size is provided, and to the medium size otherwise.
SecondaryTile secondaryTile = new SecondaryTile(MainPage.logoSecondaryTileId,
"Title text shown on the tile",
tileActivationArguments,
square150x150Logo,
TileSize.Square150x150);
// Pin the tile
bool isPinned = await tile.RequestCreateAsync();
if (isPinned) {
// Secondary tile successfully pinned.
}
else {
// Secondary tile not pinned.
}
다음 예제에서는 RequestDeleteAsync 메서드를 사용하여 보조 타일을 삭제(고정 해제)하는 방법을 보여 줍니다. 이 예제에서는 타일이 있다고 가정합니다. RequestDeleteAsync를 호출하기 전에 타일이 고정되었는지 확인하려면 Exists 메서드를 참조하세요.
// Check if the secondary tile is pinned
if (SecondaryTile.Exists(tileId)) {
// Initialize a secondary tile with the same tile ID you want removed
SecondaryTile toBeDeleted = new SecondaryTile(tileId);
// And then unpin the tile
bool isDeleted = await toBeDeleted.RequestDeleteAsync();
if (isDeleted) {
// Secondary tile successfully deleted.
} else {
// Secondary tile not deleted.
}
}
다음 예제에서는 FindAllForPackageAsync 메서드를 사용하여 호출 앱 및 동일한 패키지의 다른 앱에 대해 생성된 모든 보조 타일에 대한 ID 목록을 검색하는 방법을 보여 줍니다.
// Get all secondary tiles
var tiles = await SecondaryTile.FindAllForPackageAsync();
다음 예제에서는 TileUpdateManager.createTileUpdaterForSecondaryTile 메서드를 사용하여 ID가 "SecondaryTile.Dynamic"인 보조 타일에 알림을 보내는 방법을 보여 줍니다. 사용자가 표시되는 타일의 형식을 제어할 수 있으므로 이 예제에서는 알림의 와이드 및 제곱 버전을 모두 제공합니다.
using NotificationsExtensions.TileContent;
// Define the notification context.
// Note: This sample contains an additional reference, NotificationsExtensions, which you can use in your apps
ITileWide310x150Text04 tileContent = TileContentFactory.CreateTileWide310x150Text04();
tileContent.TextBodyWrap.Text = "Sent to a secondary tile from NotificationsExtensions!";
// Provide a square version of the notification.
ITileSquare150x150Text04 squareContent = TileContentFactory.CreateTileSquare150x150Text04();
squareContent.TextBodyWrap.Text = "Sent to a secondary tile from NotificationExtensions!";
tileContent.Square150x150Content = squareContent;
// Send the notification to the secondary tile by creating a secondary tile updater
TileUpdateManager.CreateTileUpdaterForSecondaryTile(MainPage.dynamicTileId).Update(tileContent.CreateNotification());
다음 예제에서는 BadgeUpdateManager.createBadgeUpdaterForSecondaryTile 메서드를 사용하여 ID가 "SecondaryTile.Dynamic"인 보조 타일에 숫자 배지 알림을 보내는 방법을 보여 줍니다.
using NotificationsExtensions.BadgeContent;
// Define the badge content
BadgeNumericNotificationContent badgeContent = new BadgeNumericNotificationContent(6);
// Send the notification to the secondary tile
BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile(MainPage.dynamicTileId).Update(badgeContent.CreateNotification());
생성자
SecondaryTile() |
SecondaryTile 개체를 만듭니다. 그런 다음 호출자는 타일을 고정, 업데이트 또는 삭제하기 전에 개체를 통해 필수 속성을 설정해야 합니다. 데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요. |
SecondaryTile(String) |
특정 ID를 사용하여 SecondaryTile 개체를 만듭니다. 이 형식의 생성자는 타일 업데이트 또는 삭제를 수행할 보조 타일 개체를 만드는 데 사용해야 합니다. 데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요. |
SecondaryTile(String, String, String, String, TileOptions, Uri) |
참고 이 생성자는 Windows 8.1 후 릴리스에 대해 변경되거나 사용할 수 없을 수 있습니다. 대신 SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize)을 사용합니다. SecondaryTile 개체를 중간 타일로 만듭니다. 데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요. |
SecondaryTile(String, String, String, String, TileOptions, Uri, Uri) |
참고 이 생성자는 Windows 8.1 후 릴리스에 대해 변경되거나 사용할 수 없을 수 있습니다. 대신 SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) 을 사용하고 SecondaryTile.VisualElements 메서드를 통해 다른 타일 크기와 옵션을 제공합니다. SecondaryTile 개체를 와이드 타일로 만듭니다. 데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요.
|
SecondaryTile(String, String, String, Uri, TileSize) |
중간 타일을 만드는 데 필요한 모든 필수 속성을 포함하는 SecondaryTile 개체를 만듭니다. 데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요. |
속성
Arguments |
활성화 시 보조 타일에서 앱으로 전달되는 앱 정의 정보 집합을 가져오거나 설정합니다. 이 속성은 타일을 만들 때 필요합니다. |
BackgroundColor |
참고 BackgroundColor는 Windows 8.1 후 릴리스에서 변경되거나 사용할 수 없습니다. 대신 SecondaryTileVisualElements.BackgroundColor를 사용합니다. 타일의 배경색을 가져오거나 설정합니다. |
DisplayName |
타일에 연결되고 표시되는 이름을 가져오거나 설정합니다. 이 이름은 시작의 타일, 타일의 도구 설명, 앱 목록의 작은 타일 표현 옆에, 일부 제어판 애플리케이션에 표시됩니다. 이 속성은 타일을 만들 때 필요합니다. 이는 앱의 기본 타일에 대한 매니페스트에 선언된 표시 이름과 동일합니다.
|
ForegroundText |
참고 foregroundText는 Windows 8.1 후 릴리스에 대해 변경되거나 사용할 수 없을 수 있습니다. 대신 SecondaryTileVisualElements.ForegroundText를 사용합니다. 타일에서 어둡게 또는 밝은 텍스트를 사용해야 하는지 여부를 가져오거나 설정합니다. |
LockScreenBadgeLogo |
잠금 화면에서 보조 타일을 나타내는 배지 로고 이미지의 위치를 가져오거나 설정합니다. 이 이미지를 제공하면 보조 타일이 잠금 화면에 배지를 표시할 수 있음을 선언합니다. 보조 타일이 잠금 화면의 자세한 타일 슬롯에 적합하도록 하려면 LockScreenDisplayBadgeAndTileText 속성도 True로 설정해야 합니다. 참고 보조 타일이 잠금 화면 존재에 적합하다는 것이 보장되지는 않습니다. 사용자만 7개의 잠금 화면 슬롯 중 하나에 앱을 추가할 수 있습니다. 자세한 내용은 잠금 화면 개요를 참조하세요. |
LockScreenDisplayBadgeAndTileText |
보조 타일이 잠금 화면에 배지와 자세한 타일을 모두 표시할 수 있는지 여부를 가져오거나 설정합니다. 이 속성을 True로 설정하면 LockScreenBadgeLogo 속성을 통해 배지 이미지도 제공해야 합니다. 자세한 타일 기능을 사용하지 않으려면 LockScreenBadgeLogo 속성을 통해 배지 이미지를 제공하고 LockScreenDisplayBadgeAndTileText를 False로 설정합니다. 참고 보조 타일이 잠금 화면 존재에 적합하다는 것이 보장되지는 않습니다. 사용자만 7개의 잠금 화면 슬롯 중 하나에 앱을 추가할 수 있으며, 그 중 어느 것을 선택하여 자세한 타일 정보를 표시할 수 있습니다. 자세한 내용은 잠금 화면 개요를 참조하세요. |
Logo |
참고 로고는 Windows 8.1 후 릴리스에서 변경되거나 사용할 수 없습니다. 대신 SecondaryTileVisualElements.Square150x150Logo를 사용합니다. 중간 타일에 사용되는 로고 이미지를 가져오거나 설정합니다. 이 속성은 사각형 또는 넓은 타일을 만들 때 필요합니다. |
PhoneticName |
보조 타일 이름의 윗주 버전을 가져오거나 설정합니다. UI 정렬을 위해 문자 기반 언어와 함께 사용됩니다. |
RoamingEnabled |
다른 컴퓨터에서 Microsoft 계정을 사용하여 사용자가 부모 앱을 설치할 때 보조 타일을 클라우드를 통해 다시 가져올지 여부를 결정하는 값을 가져오거나 설정합니다. Windows 8.1 기준으로 로밍이 기본 동작입니다. 이는 로밍이 옵트인된 기본 Windows 8 동작과 반대입니다.
|
ShortName |
참고 ShortName은 Windows 8.1 후 릴리스에서 변경되거나 사용할 수 없습니다. 대신 SecondaryTile.DisplayName을 사용합니다. 타일에 직접 표시할 짧은 이름을 가져오거나 설정합니다. 참고 Windows 8.1 기준으로 이 속성은 무시되고 매니페스트에 선언된 표시 이름이 해당 위치에서 사용됩니다. |
SmallLogo |
참고 SmallLogo는 Windows 8.1 후 릴리스에서 변경되거나 사용할 수 없습니다. 대신 SecondaryTileVisualElements.Square30x30Logo를 사용합니다. 검색 결과, 모든 프로그램 목록 및 UI의 다른 위치에 사용되는 작은 로고 이미지를 가져오거나 설정합니다.
|
TileId |
패키지 내에서 타일을 식별하는 고유 문자열을 가져오거나 설정합니다. 이 속성은 타일을 만들거나 삭제할 때 필요합니다. |
TileOptions |
참고 TileOptions는 Windows 8.1 후 릴리스에서 변경되거나 사용할 수 없습니다. 대신 SecondaryTile.VisualElements를 사용합니다. 보조 타일에 사용할 수 있는 옵션을 가져오거나 설정합니다. |
VisualElements |
보조 타일의 배경색, 전경 텍스트, 타일 이미지 및 앱 이름 표시 옵션을 가져오거나 설정할 수 있는 개체를 가져옵니다. Windows 8.1 기준으로 이 개체의 속성은 다음 SecondaryTile 속성을 대체합니다. |
WideLogo |
참고 WideLogo는 Windows 8.1 후 릴리스에서 변경되거나 사용할 수 없습니다. 대신 SecondaryTileVisualElements.Wide310x150Logo를 사용합니다. 넓은 보조 타일에 사용되는 로고 이미지를 가져오거나 설정합니다. 이 속성은 넓은 보조 타일을 만들 때 필요하며 타일 크기를 조정할 때 사용자에게 와이드 타일 옵션을 제공합니다. |
메서드
Exists(String) |
호출 앱에 대한 특정 보조 타일이 있는지 확인합니다. |
FindAllAsync() |
호출 앱에 대해 만들어진 보조 타일 목록을 검색합니다. |
FindAllAsync(String) |
호출 앱과 동일한 패키지의 다른 앱에 대해 만들어진 보조 타일 목록을 검색합니다. |
FindAllForPackageAsync() |
호출 앱의 패키지에 있는 모든 앱에 대해 만들어진 보조 타일 목록을 검색합니다. 앱이 시작되면 인식할 수 없는 추가 또는 삭제가 있는 경우 항상 이 메서드를 통해 보조 타일을 열거해야 합니다. 보조 타일이 시작 화면 앱 바를 통해 삭제되면 Windows에서 단순히 타일만 제거합니다. 보조 타일에서 사용된 리소스는 앱 자체에서 해제해야 합니다. 보조 타일이 클라우드를 통해 복사되는 경우 보조 타일의 현재 타일 또는 배지 알림, 예약된 알림, 푸시 알림 채널 및 주기적인 알림에 사용되는 URI(Uniform Resource Identifier)는 보조 타일과 함께 복사되지 않으므로 다시 설정해야 합니다. |
RequestCreateAsync() |
사용자가 보조 타일 을 만들 것인지 확인할 수 있는 시작 화면에 고정 플라이아웃을 표시합니다. 그러면 타일이 만들어집니다. 이 메서드의 오버로드를 사용하면 플라이아웃의 화면 위치를 지정할 수 있습니다. 참고 타일 만들기 요청을 호출한 단추 근처에 시작 화면에 고정 플라이아웃을 표시하는 것이 가장 좋습니다. 따라서 이 메서드 오버로드의 RequestCreateAsync(Point) 형식을 사용하는 것이 좋습니다.
|
RequestCreateAsync(Point) |
사용자가 보조 타일 을 만들 것인지 확인할 수 있는 지정된 위치 위에 시작 화면에 고정 플라이아웃을 표시합니다. 그러면 타일이 만들어집니다.
|
RequestCreateForSelectionAsync(Rect) |
지정된 영역 위에 시작 화면에 고정 플라이아웃을 표시합니다. 이 플라이아웃은 사용자가 보조 타일을 만들 것인지 확인하는 데 사용되며, 그러면 타일이 만들어집니다.
|
RequestCreateForSelectionAsync(Rect, Placement) |
지정된 영역의 지정된 쪽에 시작 화면에 고정 플라이아웃을 표시합니다. 이 플라이아웃은 사용자가 보조 타일을 만들 것인지 확인하는 데 사용되며, 그러면 타일이 만들어집니다.
|
RequestDeleteAsync() |
시작 플라이아웃 에서 고정 해제 를 표시합니다. 이 플라이아웃을 사용하면 사용자가 보조 타일의 제거를 확인할 수 있습니다. |
RequestDeleteAsync(Point) |
시작 플라이아웃 의 고정 해제 를 지정된 지점에 표시합니다. 이 플라이아웃을 사용하면 사용자가 보조 타일의 제거를 확인할 수 있습니다. |
RequestDeleteForSelectionAsync(Rect) |
시작 플라이아웃 의 고정 해제 를 지정된 영역 위에 표시합니다. 이 플라이아웃을 사용하면 사용자가 보조 타일의 제거를 확인할 수 있습니다. |
RequestDeleteForSelectionAsync(Rect, Placement) |
지정된 영역의 지정된 쪽에 시작 플라이아웃의 고정 해제 를 표시합니다. 이 플라이아웃을 사용하면 사용자가 보조 타일의 제거를 확인할 수 있습니다. |
UpdateAsync() |
해당 타일이 시작 화면에 고정된 후 보조 타일을 업데이트.
|
이벤트
VisualElementsRequested |
RequestCreateAsync를 호출할 때 발생합니다.
|