磚內容結構描述Tile content schema

以下說明磚內容中的所有屬性和元素。The following describes all of the properties and elements within tile content.

如果您想要使用原始 XML,而不使用 Notifications 程式庫,請參閱 XML 結構描述If you would rather use raw XML instead of the Notifications library, please see the XML schema.

TileContentTileContent

TileContentTileContent

TileContent 是描述磚通知內容 (包括視覺效果) 的最上層物件。TileContent is the top level object that describes a tile notification's content, including visuals.

屬性Property 類型Type 必要Required 描述Description
VisualVisual ToastVisualToastVisual truetrue 描述磚通知的視覺效果部分。Describes the visual portion of the tile notification.

TileVisualTileVisual

磚的視覺效果部分包含所有磚大小的視覺規格,以及更多視覺相關屬性。The visual portion of tiles contains the visual specifications for all tile sizes, and more visual-related properties.

屬性Property 類型Type 必要Required 描述Description
TileSmallTileSmall TileBindingTileBinding falsefalse 提供選擇性小型繫結,以指定小型磚大小的內容。Provide an optional small binding to specify content for the small tile size.
TileMediumTileMedium TileBindingTileBinding falsefalse 提供選擇性中型繫結,以指定中型磚大小的內容。Provide an optional medium binding to specify content for the medium tile size.
TileWideTileWide TileBindingTileBinding falsefalse 提供選擇性寬型繫結,以指定寬型磚大小的內容。Provide an optional wide binding to specify content for the wide tile size.
TileLargeTileLarge TileBindingTileBinding falsefalse 提供選擇性大型繫結,以指定大型磚大小的內容。Provide an optional large binding to specify content for the large tile size.
商標Branding TileBrandingTileBranding falsefalse 磚應用來顯示應用程式品牌的表單。The form that the tile should use to display the app's brand. 根據預設,繼承自預設磚的品牌。By default, inherits branding from the default tile.
DisplayNameDisplayName 字串string falsefalse 選擇性字串,顯示此通知時會覆寫磚的顯示名稱。An optional string to override the tile's display name while showing this notification.
引數Arguments 字串string falsefalse 年度更新版的新功能:應用程式定義的資料,當使用者透過動態磚啟動您的應用程式,會透過 LaunchActivatedEventArgs 上的 TileActivatedInfo 屬性傳回至您的應用程式。New in Anniversary Update: App-defined data that is passed back to your app via the TileActivatedInfo property on LaunchActivatedEventArgs when the user launches your app from the Live Tile. 這可讓您知道當使用者點選動態磚時,看到哪個磚通知。This allows you to know which tile notifications your user saw when they tapped your Live Tile. 在沒有年度更新版的裝置上,這會被忽略。On devices without the Anniversary Update, this will simply be ignored.
LockDetailedStatus1LockDetailedStatus1 字串string falsefalse 若您指定此項,也必須提供 TileWide 繫結。If you specify this, you must also provide a TileWide binding. 如果使用者選取磚做為詳細狀態應用程式,這會是顯示在鎖定畫面上的第一行文字。This is the first line of text that will be displayed on the lock screen if the user has selected your tile as their detailed status app.
LockDetailedStatus2LockDetailedStatus2 字串string falsefalse 若您指定此項,也必須提供 TileWide 繫結。If you specify this, you must also provide a TileWide binding. 如果使用者選取磚做為詳細狀態應用程式,這會是顯示在鎖定畫面上的第二行文字。This is the second line of text that will be displayed on the lock screen if the user has selected your tile as their detailed status app.
LockDetailedStatus3LockDetailedStatus3 字串string falsefalse 若您指定此項,也必須提供 TileWide 繫結。If you specify this, you must also provide a TileWide binding. 如果使用者選取磚做為詳細狀態應用程式,這會是顯示在鎖定畫面上的第三行文字。This is the third line of text that will be displayed on the lock screen if the user has selected your tile as their detailed status app.
BaseUriBaseUri UriUri falsefalse 與影像來源屬性中的相對 URL 結合的預設基底 URL。A default base URL that is combined with relative URLs in image source attributes.
AddImageQueryAddImageQuery bool?bool? falsefalse 設定為 "true" 可讓 Windows 將查詢字串附加至快顯通知中提供的影像 URL。Set to "true" to allow Windows to append a query string to the image URL supplied in the toast notification. 如果您的伺服器裝載影像,並且可以處理查詢字串 (方式為根據查詢字串擷取影像變體,或忽略查詢字串並傳回未使用查詢字串所指定的影像),請使用此屬性。Use this attribute if your server hosts images and can handle query strings, either by retrieving an image variant based on the query strings or by ignoring the query string and returning the image as specified without the query string. 此查詢字串指定比例、對比設定和語言。例如,通知中指定的 "www.website.com/images/hello.png" 值會變成 "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"This query string specifies scale, contrast setting, and language; for instance, a value of "www.website.com/images/hello.png" given in the notification becomes "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
語言Language 字串string falsefalse 使用當地語系化資源時的視覺效果承載目標地區設定,指定為 BCP-47 語言標記,例如 "en-US" 或 "fr-FR"。The target locale of the visual payload when using localized resources, specified as BCP-47 language tags such as "en-US" or "fr-FR". 繫結或文字中指定的任何地區設定都會覆寫此地區設定。This locale is overridden by any locale specified in binding or text. 如果未提供,則改用系統地區設定。If not provided, the system locale will be used instead.

TileBindingTileBinding

繫結物件包含特定磚大小的視覺內容。The binding object contains the visual content for a specific tile size.

屬性Property 類型Type 必要Required 描述Description
內容Content ITileBindingContentITileBindingContent falsefalse 要在磚上顯示的視覺內容。The visual content to display on the tile. 其中一個 TileBindingContentAdaptiveTileBindingContentIconicTileBindingContentContactTileBindingContentPeopleTileBindingContentPhotosOne of TileBindingContentAdaptive, TileBindingContentIconic, TileBindingContentContact, TileBindingContentPeople, or TileBindingContentPhotos.
商標Branding TileBrandingTileBranding falsefalse 磚應用來顯示應用程式品牌的表單。The form that the tile should use to display the app's brand. 根據預設,繼承自預設磚的品牌。By default, inherits branding from the default tile.
DisplayNameDisplayName 字串string falsefalse 選擇性字串,覆寫此磚大小的磚顯示名稱。An optional string to override the tile's display name for this tile size.
引數Arguments 字串string falsefalse 年度更新版的新功能:應用程式定義的資料,當使用者透過動態磚啟動您的應用程式,會透過 LaunchActivatedEventArgs 上的 TileActivatedInfo 屬性傳回至您的應用程式。New in Anniversary Update: App-defined data that is passed back to your app via the TileActivatedInfo property on LaunchActivatedEventArgs when the user launches your app from the Live Tile. 這可讓您知道當使用者點選動態磚時,看到哪個磚通知。This allows you to know which tile notifications your user saw when they tapped your Live Tile. 在沒有年度更新版的裝置上,這會被忽略。On devices without the Anniversary Update, this will simply be ignored.
BaseUriBaseUri UriUri falsefalse 與影像來源屬性中的相對 URL 結合的預設基底 URL。A default base URL that is combined with relative URLs in image source attributes.
AddImageQueryAddImageQuery bool?bool? falsefalse 設定為 "true" 可讓 Windows 將查詢字串附加至快顯通知中提供的影像 URL。Set to "true" to allow Windows to append a query string to the image URL supplied in the toast notification. 如果您的伺服器裝載影像,並且可以處理查詢字串 (方式為根據查詢字串擷取影像變體,或忽略查詢字串並傳回未使用查詢字串所指定的影像),請使用此屬性。Use this attribute if your server hosts images and can handle query strings, either by retrieving an image variant based on the query strings or by ignoring the query string and returning the image as specified without the query string. 此查詢字串指定比例、對比設定和語言。例如,通知中指定的 "www.website.com/images/hello.png" 值會變成 "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"This query string specifies scale, contrast setting, and language; for instance, a value of "www.website.com/images/hello.png" given in the notification becomes "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
語言Language 字串string falsefalse 使用當地語系化資源時的視覺效果承載目標地區設定,指定為 BCP-47 語言標記,例如 "en-US" 或 "fr-FR"。The target locale of the visual payload when using localized resources, specified as BCP-47 language tags such as "en-US" or "fr-FR". 繫結或文字中指定的任何地區設定都會覆寫此地區設定。This locale is overridden by any locale specified in binding or text. 如果未提供,則改用系統地區設定。If not provided, the system locale will be used instead.

ITileBindingContentITileBindingContent

磚繫結內容的標記介面。Marker interface for tile binding content. 這些可讓您選擇想以什麼指定您的磚視覺效果 - 彈性,或其中一個特殊範本。These let you choose what you want to specify your tile visuals in - Adaptive, or one of the special templates.

實作Implementations
TileBindingContentAdaptiveTileBindingContentAdaptive
TileBindingContentIconicTileBindingContentIconic
TileBindingContentContactTileBindingContentContact
TileBindingContentPeopleTileBindingContentPeople
TileBindingContentPhotosTileBindingContentPhotos

TileBindingContentAdaptiveTileBindingContentAdaptive

支援所有的大小。Supported on all sizes. 這是指定磚內容的建議方式。This is the recommended way of specifying your tile content. 彈性磚範本是 Windows 10 的新功能,您可以透過彈性建立各種不同的自訂磚。Adaptive Tile templates new in Windows 10, and you can create a wide variety of custom tiles through adaptive.

屬性Property 類型Type 必要Required 描述Description
子系Children IListIList falsefalse 內嵌視覺元素。The inline visual elements. 可以新增 AdaptiveTextAdaptiveImageAdaptiveGroup 物件。AdaptiveText, AdaptiveImage, and AdaptiveGroup objects can be added. 這些子系會以垂直 StackPanel 方式顯示。The children are displayed in a vertical StackPanel fashion.
BackgroundImageBackgroundImage TileBackgroundImageTileBackgroundImage falsefalse 選用背景影像,會顯示在所有磚內容後面,跨頁顯示。An optional background image that gets displayed behind all the Tile content, full bleed.
PeekImagePeekImage TilePeekImageTilePeekImage falsefalse 選用預覽影像,可從磚的上方動畫顯示進來。An optional peek image that animates in from the top of the Tile.
TextStackingTextStacking TileTextStackingTileTextStacking falsefalse 控制整體子系內容的文字堆疊 (垂直對齊)。Controls the text stacking (vertical alignment) of the children content as a whole.

AdaptiveTextAdaptiveText

調適性文字元素。An adaptive text element.

屬性Property 類型Type 必要Required 描述Description
TextText 字串string falsefalse 要顯示的文字。The text to display.
HintStyleHintStyle AdaptiveTextStyleAdaptiveTextStyle falsefalse 此樣式會控制文字的字型大小、粗細和不透明度。The style controls the text's font size, weight, and opacity.
HintWrapHintWrap bool?bool? falsefalse 將此設定為 true 可啟用文字換行。Set this to true to enable text wrapping. 預設為 false。Default to false.
HintMaxLinesHintMaxLines int?int? falsefalse 允許文字元素顯示的最大行數。The maximum number of lines the text element is allowed to display.
HintMinLinesHintMinLines int?int? falsefalse 文字元素必須顯示的最小行數。The minimum number of lines the text element must display.
HintAlignHintAlign AdaptiveTextAlignAdaptiveTextAlign falsefalse 文字的水平對齊。The horizontal alignment of the text.
語言Language 字串string falsefalse 指定為 BCP-47 語言標記的 XML 承載目標地區設定,例如 "en-US" or "fr-FR"。The target locale of the XML payload, specified as a BCP-47 language tags such as "en-US" or "fr-FR". 此處指定的地區設定會覆寫任何其他位置 (例如繫結或視覺效果) 指定的地區設定。The locale specified here overrides any other specified locale, such as that in binding or visual. 如果此值為常值字串,則此屬性預設為使用者的 UI 語言。If this value is a literal string, this attribute defaults to the user's UI language. 如果此值為字串參考,則此屬性預設為 Windows 執行階段在解析字串時所選擇的地區設定。If this value is a string reference, this attribute defaults to the locale chosen by Windows Runtime in resolving the string.

AdaptiveTextStyleAdaptiveTextStyle

文字樣式會控制字型大小、粗細和不透明度。Text style controls font size, weight, and opacity. 輕微不透明度是 60% 不透明。Subtle opacity is 60% opaque.

Value 意義Meaning
預設值Default 預設值。Default value. 樣式取決於轉譯器。Style is determined by the renderer.
標題Caption 小於段落字型大小。Smaller than paragraph font size.
CaptionSubtleCaptionSubtle 和 Caption 一樣,只是有輕微不透明度。Same as Caption but with subtle opacity.
本文Body 段落字型大小。Paragraph font size.
BodySubtleBodySubtle 和 Body 一樣,只是有輕微不透明度。Same as Body but with subtle opacity.
基地Base 段落字型大小、粗體粗細。Paragraph font size, bold weight. 基本上是 Body 的粗體版本。Essentially the bold version of Body.
BaseSubtleBaseSubtle 和 Base 一樣,只是有輕微不透明度。Same as Base but with subtle opacity.
副標題Subtitle H4 字型大小。H4 font size.
SubtitleSubtleSubtitleSubtle 和 Subtitle 一樣,只是有輕微不透明度。Same as Subtitle but with subtle opacity.
標題Title H3 字型大小。H3 font size.
TitleSubtleTitleSubtle 和 Title 一樣,只是有輕微不透明度。Same as Title but with subtle opacity.
TitleNumeralTitleNumeral 和 Title 一樣,只是上/下邊框間距已移除。Same as Title but with top/bottom padding removed.
Subheader.aboutdocsSubheader H2 字型大小。H2 font size.
SubheaderSubtleSubheaderSubtle 和 Subheader 一樣,只是有輕微不透明度。Same as Subheader but with subtle opacity.
SubheaderNumeralSubheaderNumeral 和 Subheader 一樣,只是上/下邊框間距已移除。Same as Subheader but with top/bottom padding removed.
標頭Header H1 字型大小。H1 font size.
HeaderSubtleHeaderSubtle 和 Header 一樣,只是有輕微不透明度。Same as Header but with subtle opacity.
HeaderNumeralHeaderNumeral 和 Header 一樣,只是上/下邊框間距已移除。Same as Header but with top/bottom padding removed.

AdaptiveTextAlignAdaptiveTextAlign

控制文字的水平對齊。Controls the horizontal alignmen of text.

Value 意義Meaning
預設值Default 預設值。Default value. 對齊方式自動由轉譯器決定。Alignment is automatically determined by the renderer.
AutoAuto 對齊方式取決於目前的語言及文化特性。Alignment determined by the current language and culture.
離開Left 將文字水平對齊左側。Horizontally align the text to the left.
中心Center 將文字水平對齊中央。Horizontally align the text in the center.
Right 將文字水平對齊右側。Horizontally align the text to the right.

AdaptiveImageAdaptiveImage

內嵌影像。An inline image.

屬性Property 類型Type 必要Required 描述Description
SourceSource 字串string truetrue 影像的 URL。The URL to the image. 支援 ms-appx、ms-appdata 和 http。ms-appx, ms-appdata, and http are supported. 從 Fall Creators Update 開始,一般連線的網頁影像可以高達 3 MB,而計量付費連線可以高達 1 MB。As of the Fall Creators Update, web images can be up to 3 MB on normal connections and 1 MB on metered connections. 在尚未執行 Fall Creators Update 的裝置上,網頁影像不得超過 200 KB。On devices not yet running the Fall Creators Update, web images must be no larger than 200 KB.
HintCropHintCrop AdaptiveImageCropAdaptiveImageCrop falsefalse 控制影像所需的裁剪。Control the desired cropping of the image.
HintRemoveMarginHintRemoveMargin bool?bool? falsefalse 群組/子群組內的影像周圍預設會有 8px 邊界。By default, images inside groups/subgroups have an 8px margin around them. 您可將此屬性設定為 true 以移除此邊界。You can remove this margin by setting this property to true.
HintAlignHintAlign AdaptiveImageAlignAdaptiveImageAlign falsefalse 影像的水平對齊。The horizontal alignment of the image.
AlternateTextAlternateText 字串string falsefalse 描述影像的替代文字,用於協助工具用途。Alternate text describing the image, used for accessibility purposes.
AddImageQueryAddImageQuery bool?bool? falsefalse 設定為 "true" 可讓 Windows 將查詢字串附加至磚通知中提供的影像 URL。Set to "true" to allow Windows to append a query string to the image URL supplied in the tile notification. 如果您的伺服器裝載影像,並且可以處理查詢字串 (方式為根據查詢字串擷取影像變體,或忽略查詢字串並傳回未使用查詢字串所指定的影像),請使用此屬性。Use this attribute if your server hosts images and can handle query strings, either by retrieving an image variant based on the query strings or by ignoring the query string and returning the image as specified without the query string. 此查詢字串指定比例、對比設定和語言。例如,通知中指定的 "www.website.com/images/hello.png" 值會變成 "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"This query string specifies scale, contrast setting, and language; for instance, a value of "www.website.com/images/hello.png" given in the notification becomes "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

AdaptiveImageCropAdaptiveImageCrop

指定影像所需的裁剪。Specifies the desired cropping of the image.

Value 意義Meaning
預設值Default 預設值。Default value. 裁剪行為取決於轉譯器。Cropping behavior determined by renderer.
None 不裁剪影像。Image is not cropped.
CircleCircle 將影像裁剪成圓形形狀。Image is cropped to a circle shape.

AdaptiveImageAlignAdaptiveImageAlign

指定影像的水平對齊方式。Specifies the horizontal alignment for an image.

Value 意義Meaning
預設值Default 預設值。Default value. 對齊行為取決於轉譯器。Alignment behavior determined by renderer.
延展Stretch 影像自動縮放到填滿可用寬度 (和可能會有的可用高度,視放置影像的位置而定)。Image stretches to fill available width (and potentially available height too, depending on where the image is placed).
離開Left 將影像對齊左側,並以其原生解析度來顯示影像。Align the image to the left, displaying the image at its native resolution.
中心Center 將影像對齊中央,並以其原生解析度來顯示影像。Align the image in the center horizontally, displayign the image at its native resolution.
Right 將影像對齊右側,並以其原生解析度來顯示影像。Align the image to the right, displaying the image at its native resolution.

AdaptiveGroupAdaptiveGroup

群組會在語意上識別,群組中的內容必須完整顯示,如果無法容納其中,則不顯示。Groups semantically identify that the content in the group must either be displayed as a whole, or not displayed if it cannot fit. 群組也允許建立多欄。Groups also allow creating multiple columns.

屬性Property 類型Type 必要Required 描述Description
子系Children IList<AdaptiveSubgroup>IList<AdaptiveSubgroup> falsefalse 子群組會顯示為垂直欄。Subgroups are displayed as vertical columns. 要在 AdaptiveGroup 中提供任何內容,您必須使用子群組。You must use subgroups to provide any content inside an AdaptiveGroup.

AdaptiveSubgroupAdaptiveSubgroup

子群組是可容納文字和影像的垂直欄。Subgroups are vertical columns that can contain text and images.

屬性Property 類型Type 必要Required 描述Description
子系Children IList<IAdaptiveSubgroupChild>IList<IAdaptiveSubgroupChild> falsefalse AdaptiveTextAdaptiveImage 是子群組的有效子系。AdaptiveText and AdaptiveImage are valid children of subgroups.
HintWeightHintWeight int?int? falsefalse 藉由指定相對於其他子群組的粗細,控制這個子群組欄的寬度。Control the width of this subgroup column by specifying the weight, relative to the other subgroups.
HintTextStackingHintTextStacking AdaptiveSubgroupTextStackingAdaptiveSubgroupTextStacking falsefalse 控制這個子群組內容的垂直對齊方式。Control the vertical alignment of this subgroup's content.

IAdaptiveSubgroupChildIAdaptiveSubgroupChild

子群組子系的標記介面。Marker interface for subgroup children.

實作Implementations
AdaptiveTextAdaptiveText
AdaptiveImageAdaptiveImage

AdaptiveSubgroupTextStackingAdaptiveSubgroupTextStacking

TextStacking 指定內容的垂直對齊方式。TextStacking specifies the vertical alignment of content.

Value 意義Meaning
預設值Default 預設值。Default value. 轉譯器自動選取預設垂直對齊方式。Renderer automatically selects the default vertical alignment.
前幾個Top 垂直對齊最上方。Vertical align to the top.
中心Center 垂直對齊中央。Vertical align to the center.
底端Bottom 垂直對齊底部。Vertical align to the bottom.

TileBackgroundImageTileBackgroundImage

背景影像會在磚上跨頁顯示。A background image displayed full-bleed on the tile.

屬性Property 類型Type 必要Required 描述Description
SourceSource 字串string truetrue 影像的 URL。The URL to the image. 支援 ms-appx、ms-appdata 和 http(s)。ms-appx, ms-appdata, and http(s) are supported. Http 影像的大小必須是 200 KB 或更少。Http images must be 200 KB or less in size.
HintOverlayHintOverlay int?int? falsefalse 背景影像上的全黑重疊。A black overlay on the background image. 此值控制全黑重疊的透明度,0 代表不重疊,100 代表全黑。This value controls the opacity of the black overlay, with 0 being no overlay and 100 being completely black. 預設為 20。Defaults to 20.
HintCropHintCrop TileBackgroundImageCropTileBackgroundImageCrop falsefalse 1511 中的新功能:指定想要裁剪影像的方式。New in 1511: Specify how you would like the image to be cropped. 在 1511 之前的版本中,這將會被忽略,背景影像不使用任何裁剪來顯示。In versions before 1511, this will be ignored and background image will be displayed without any cropping.
AlternateTextAlternateText 字串string falsefalse 描述影像的替代文字,用於協助工具用途。Alternate text describing the image, used for accessibility purposes.
AddImageQueryAddImageQuery bool?bool? falsefalse 設定為 "true" 可讓 Windows 將查詢字串附加至磚通知中提供的影像 URL。Set to "true" to allow Windows to append a query string to the image URL supplied in the tile notification. 如果您的伺服器裝載影像,並且可以處理查詢字串 (方式為根據查詢字串擷取影像變體,或忽略查詢字串並傳回未使用查詢字串所指定的影像),請使用此屬性。Use this attribute if your server hosts images and can handle query strings, either by retrieving an image variant based on the query strings or by ignoring the query string and returning the image as specified without the query string. 此查詢字串指定比例、對比設定和語言。例如,通知中指定的 "www.website.com/images/hello.png" 值會變成 "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"This query string specifies scale, contrast setting, and language; for instance, a value of "www.website.com/images/hello.png" given in the notification becomes "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TileBackgroundImageCropTileBackgroundImageCrop

控制背景影像的裁剪。Controls the cropping of the background image.

Value 意義Meaning
預設值Default 裁剪時會使用轉譯器的預設行為。Cropping uses the default behavior of the renderer.
None 不裁剪影像,顯示為正方形。Image is not cropped, displayed square.
CircleCircle 將影像裁剪成圓形。Image is cropped to a circle.

TilePeekImageTilePeekImage

預覽影像,可從磚的上方動畫顯示進來。A peek image that animates in from the top of the tile.

屬性Property 類型Type 必要Required 描述Description
SourceSource 字串string truetrue 影像的 URL。The URL to the image. 支援 ms-appx、ms-appdata 和 http(s)。ms-appx, ms-appdata, and http(s) are supported. Http 影像的大小必須是 200 KB 或更少。Http images must be 200 KB or less in size.
HintOverlayHintOverlay int?int? falsefalse 1511 中的新功能:預覽影像上的黑色重疊。New in 1511: A black overlay on the peek image. 此值控制全黑重疊的透明度,0 代表不重疊,100 代表全黑。This value controls the opacity of the black overlay, with 0 being no overlay and 100 being completely black. 預設為 20。Defaults to 20. 在舊版中,將會忽略此值,並以 0 重疊顯示預覽影像。In previous versions, this value will be ignored and peek image will be displayed with 0 overlay.
HintCropHintCrop TilePeekImageCropTilePeekImageCrop falsefalse 1511 中的新功能:指定想要裁剪影像的方式。New in 1511: Specify how you would like the image to be cropped. 在 1511 之前的版本中,這將會被忽略,預覽影像不使用任何裁剪來顯示。In versions before 1511, this will be ignored and peek image will be displayed without any cropping.
AlternateTextAlternateText 字串string falsefalse 描述影像的替代文字,用於協助工具用途。Alternate text describing the image, used for accessibility purposes.
AddImageQueryAddImageQuery bool?bool? falsefalse 設定為 "true" 可讓 Windows 將查詢字串附加至磚通知中提供的影像 URL。Set to "true" to allow Windows to append a query string to the image URL supplied in the tile notification. 如果您的伺服器裝載影像,並且可以處理查詢字串 (方式為根據查詢字串擷取影像變體,或忽略查詢字串並傳回未使用查詢字串所指定的影像),請使用此屬性。Use this attribute if your server hosts images and can handle query strings, either by retrieving an image variant based on the query strings or by ignoring the query string and returning the image as specified without the query string. 此查詢字串指定比例、對比設定和語言。例如,通知中指定的 "www.website.com/images/hello.png" 值會變成 "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"This query string specifies scale, contrast setting, and language; for instance, a value of "www.website.com/images/hello.png" given in the notification becomes "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TilePeekImageCropTilePeekImageCrop

控制預覽影像的裁剪。Controls the cropping of the peek image.

Value 意義Meaning
預設值Default 裁剪時會使用轉譯器的預設行為。Cropping uses the default behavior of the renderer.
None 不裁剪影像,顯示為正方形。Image is not cropped, displayed square.
CircleCircle 將影像裁剪成圓形。Image is cropped to a circle.

TileTextStackingTileTextStacking

文字堆疊指定內容的垂直對齊方式。Text stacking specifies the vertical alignment of the content.

Value 意義Meaning
預設值Default 預設值。Default value. 轉譯器自動選取預設垂直對齊方式。Renderer automatically selects the default vertical alignment.
前幾個Top 垂直對齊最上方。Vertical align to the top.
中心Center 垂直對齊中央。Vertical align to the center.
底端Bottom 垂直對齊底部。Vertical align to the bottom.

TileBindingContentIconicTileBindingContentIconic

支援小型和中型。Supported on Small and Medium. 啟用圖示磚範本,您可以真正的經典 Windows Phone 樣式,在磚的每個項目旁顯示圖示和徽章。Enables an iconic tile template, where you can have an icon and badge display next to each other on the tile, in true classic Windows Phone style. 圖示旁邊的號碼透過不同徽章通知達成。The number next to the icon is achieved through a separate badge notification.

屬性Property 類型Type 必要Required 描述Description
圖示Icon TileBasicImageTileBasicImage truetrue 至少支援桌面和行動裝置版、小型和中型磚,提供正方形的長寬比例影像、解析度 200x200、PNG 格式、具有透明度,只使用白色。At minimum, to support both Desktop and Mobile, Small and Medium tiles, provide a square aspect ratio image with a resolution of 200x200, PNG format, with transparency and no color other than white. 如需詳細資訊,請參閱:特殊磚範本For more info see: Special Tile Templates.

TileBindingContentContactTileBindingContentContact

僅限行動裝置版。Mobile-only. 支援小型、中型和寬型。Supported on Small, Medium, and Wide.

屬性Property 類型Type 必要Required 描述Description
映像Image TileBasicImageTileBasicImage truetrue 要顯示的影像。The image to display.
TextText TileBasicTextTileBasicText falsefalse 要顯示的文字行。A line of text that is displayed. 不會顯示在小型磚上。Not displayed on small tile.

TileBindingContentPeopleTileBindingContentPeople

1511 中的新功能:支援中型、寬型以及大型 (桌面和行動裝置版)。New in 1511: Supported on Medium, Wide, and Large (Desktop and Mobile). 之前此功能僅限行動裝置版並僅限中型及寬型。Previously this was Mobile-only and only Medium and Wide.

屬性Property 類型Type 必要Required 描述Description
影像Images IList<TileBasicImage>IList<TileBasicImage> truetrue 影像會以圓圈滾動。Images that will roll around as circles.

TileBindingContentPhotosTileBindingContentPhotos

透過相片的投影片製作動畫。Animates through a slideshow of photos. 支援所有的大小。Supported on all sizes.

屬性Property 類型Type 必要Required 描述Description
影像Images IList<TileBasicImage>IList<TileBasicImage> truetrue 可提供高達 12 個影像 (行動裝置版只會顯示最多 9 個),將用於投影片放映。Up to 12 images can be provided (Mobile will only display up to 9), which will be used for the slideshow. 新增超過 12 個會擲回例外狀況。Adding more than 12 will throw an exception.

TileBasicImageTileBasicImage

用於各種特殊範本的影像。An image used on various special templates.

屬性Property 類型Type 必要Required 描述Description
SourceSource 字串string truetrue 影像的 URL。The URL to the image. 支援 ms-appx、ms-appdata 和 http(s)。ms-appx, ms-appdata, and http(s) are supported. Http 影像的大小必須是 200 KB 或更少。Http images must be 200 KB or less in size.
AlternateTextAlternateText 字串string falsefalse 描述影像的替代文字,用於協助工具用途。Alternate text describing the image, used for accessibility purposes.
AddImageQueryAddImageQuery bool?bool? falsefalse 設定為 "true" 可讓 Windows 將查詢字串附加至磚通知中提供的影像 URL。Set to "true" to allow Windows to append a query string to the image URL supplied in the tile notification. 如果您的伺服器裝載影像,並且可以處理查詢字串 (方式為根據查詢字串擷取影像變體,或忽略查詢字串並傳回未使用查詢字串所指定的影像),請使用此屬性。Use this attribute if your server hosts images and can handle query strings, either by retrieving an image variant based on the query strings or by ignoring the query string and returning the image as specified without the query string. 此查詢字串指定比例、對比設定和語言。例如,通知中指定的 "www.website.com/images/hello.png" 值會變成 "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"This query string specifies scale, contrast setting, and language; for instance, a value of "www.website.com/images/hello.png" given in the notification becomes "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TileBasicTextTileBasicText

用於各種特殊範本的基本文字元素。A basic text element used on various special templates.

屬性Property 類型Type 必要Required 描述Description
TextText 字串string falsefalse 要顯示的文字。The text to display.
語言Language 字串string falsefalse 指定為 BCP-47 語言標記的 XML 承載目標地區設定,例如 "en-US" or "fr-FR"。The target locale of the XML payload, specified as a BCP-47 language tags such as "en-US" or "fr-FR". 此處指定的地區設定會覆寫任何其他位置 (例如繫結或視覺效果) 指定的地區設定。The locale specified here overrides any other specified locale, such as that in binding or visual. 如果此值為常值字串,則此屬性預設為使用者的 UI 語言。If this value is a literal string, this attribute defaults to the user's UI language. 如果此值為字串參考,則此屬性預設為 Windows 執行階段在解析字串時所選擇的地區設定。If this value is a string reference, this attribute defaults to the locale chosen by Windows Runtime in resolving the string.