Schemat zawartości kafelka

Note

Live Tiles to funkcja systemu Windows 10, która nie jest obsługiwana w nowszych wersjach systemu Windows. W przypadku nowych aplikacji zalecamy przestrzeganie bieżących wskazówek dotyczących ikon aplikacji.

Poniżej opisano wszystkie właściwości i elementy w zawartości kafelka.

Jeśli wolisz używać nieprzetworzonego kodu XML zamiast biblioteki Powiadomień, zobacz schemat XML.

Zawartość kafelka

TileContent to obiekt najwyższego poziomu, który opisuje zawartość powiadomienia kafelka, w tym wizualizacje.

Właściwości Typ Required Description
Wizualny ToastVisual prawda Opisuje wizualną część powiadomienia kafelka.

KafelekVisual

Część wizualizacji kafelków zawiera specyfikacje wizualizacji dla wszystkich rozmiarów kafelków i więcej właściwości związanych z wizualizacją.

Właściwości Typ Required Description
TileSmall TileBinding false Podaj opcjonalne powiązanie dla małego kafelka, aby określić jego zawartość.
TileMedium TileBinding false Podaj opcjonalne powiązanie dla średniego kafelka, aby określić zawartość dla średniego rozmiaru kafelka.
TileWide TileBinding false Podaj opcjonalne szerokie powiązanie, aby określić zawartość dla szerokiego kafelka.
TileLarge TileBinding false Podaj opcjonalne duże powiązanie, aby określić zawartość dla dużego rozmiaru kafelka.
Marki TileBranding false Forma, której powinien używać kafelek do wyświetlania marki aplikacji. Domyślnie dziedziczy branding z domyślnego kafelka.
DisplayName ciąg false Opcjonalny ciąg do nadpisania nazwy wyświetlanej kafelka podczas wyświetlania tego powiadomienia.
Arguments ciąg false Nowość w aktualizacji rocznicowej: dane zdefiniowane przez aplikację, które są przekazywane z powrotem do aplikacji za pośrednictwem właściwości TileActivatedInfo w obszarze LaunchActivatedEventArgs, gdy użytkownik uruchamia aplikację z dynamicznego kafelka. Dzięki temu możesz dowiedzieć się, które powiadomienia kafelków użytkownik zobaczył, gdy stuknął Twój Live Tile. Na urządzeniach bez Anniversary Update będzie to po prostu ignorowane.
LockDetailedStatus1 ciąg false Jeśli określisz to, musisz również podać powiązanie TileWide. Jest to pierwszy wiersz tekstu, który będzie wyświetlany na ekranie blokady, jeśli użytkownik wybrał Twój kafelek jako aplikację szczegółowego stanu.
LockDetailedStatus2 ciąg false Jeśli określisz to, musisz również podać powiązanie TileWide. Jest to drugi wiersz tekstu, który będzie wyświetlany na ekranie blokady, jeśli użytkownik wybrał Twój kafelek jako swoją aplikację szczegółowego stanu.
LockDetailedStatus3 ciąg false Jeśli określisz to, musisz również podać powiązanie TileWide. Jest to trzeci wiersz tekstu, który będzie wyświetlany na ekranie blokady, jeśli użytkownik wybrał Twój kafelek jako aplikację szczegółowego stanu.
BaseUri Uri false Domyślny podstawowy adres URL połączony z względnymi adresami URL w atrybutach źródła obrazu.
AddImageQuery bool? false Ustaw „true”, aby umożliwić Windows dołączanie ciągu zapytania do adresu URL obrazu podanego w powiadomieniu wyskakującym. Użyj tego atrybutu, jeśli serwer hostuje obrazy i może obsługiwać ciągi zapytania, pobierając wariant obrazu na podstawie ciągów zapytania lub ignorując ciąg zapytania i zwracając obraz zgodnie z opisem bez ciągu zapytania. Ten ciąg zapytania określa skalę, ustawienie kontrastu i język; na przykład wartość "www.website.com/images/hello.png" podana w powiadomieniu staje się "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
Language ciąg false Docelowe ustawienia regionalne treści wizualnej podczas używania zlokalizowanych zasobów, określone jako tagi języka BCP-47, takich jak "en-US" lub "fr-FR". Te ustawienia regionalne są zastępowane przez dowolne ustawienia regionalne określone w powiązaniu lub tekście. Jeśli nie zostanie podana, zostaną użyte ustawienia regionalne systemu.

TileBinding

Obiekt powiązania zawiera zawartość wizualną dla określonego rozmiaru kafelka.

Właściwości Typ Required Description
Content ITileBindingContent false Zawartość wizualizacji do wyświetlenia na kafelku. Jeden z elementów TileBindingContentAdaptive, TileBindingContentIconic, TileBindingContentContact, TileBindingContentPeople lub TileBindingContentPhotos.
Marki TileBranding false Forma, której powinien używać kafelek do wyświetlania marki aplikacji. Domyślnie dziedziczy znakowanie z domyślnego kafelka.
DisplayName ciąg false Opcjonalny ciąg, który zastąpi wyświetlaną nazwę kafelka dla tego rozmiaru kafelka.
Arguments ciąg false Nowość w aktualizacji rocznicowej: dane zdefiniowane przez aplikację, które są przekazywane z powrotem do aplikacji za pośrednictwem właściwości TileActivatedInfo w obszarze LaunchActivatedEventArgs, gdy użytkownik uruchamia aplikację z dynamicznego kafelka. Dzięki temu możesz dowiedzieć się, które powiadomienia kafelków były wyświetlane użytkownikowi po naciśnięciu dynamicznego kafelka. Na urządzeniach bez rocznicowej aktualizacji będzie to po prostu ignorowane.
BaseUri Uri false Domyślny podstawowy adres URL połączony z względnymi adresami URL w atrybutach źródła obrazu.
AddImageQuery bool? false Ustaw „true”, aby umożliwić Windows dołączanie ciągu zapytania do adresu URL obrazu podanego w powiadomieniu wyskakującym. Użyj tego atrybutu, jeśli serwer hostuje obrazy i może obsługiwać ciągi zapytania, pobierając wariant obrazu na podstawie ciągów zapytania lub ignorując ciąg zapytania i zwracając obraz zgodnie z opisem bez ciągu zapytania. Ten ciąg zapytania określa skalę, ustawienie kontrastu i język; na przykład wartość "www.website.com/images/hello.png" podana w powiadomieniu staje się "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
Language ciąg false Docelowe ustawienia regionalne treści wizualnej podczas używania zlokalizowanych zasobów, określone jako tagi języka BCP-47, takich jak "en-US" lub "fr-FR". Te ustawienia regionalne są zastępowane przez dowolne ustawienia regionalne określone w powiązaniu lub tekście. Jeśli nie zostanie podana, zostaną użyte ustawienia regionalne systemu.

ITileBindingContent

Interfejs markerowy dla zawartości powiązania dla kafelka. Umożliwiają one wybranie elementów wizualnych kafelków w trybie — adaptacyjnym lub jednym z szablonów specjalnych.

Implementacje
TileBindingContentAdaptive
TileBindingContentIconic
TileBindingContentContact
TileBindingContentPeople
TileBindingContentPhotos

TileBindingContentAdaptive

Obsługiwane we wszystkich rozmiarach. Jest to zalecany sposób określania zawartości kafelka. Adaptacyjne szablony kafelków są nowe w Windows 10 i można utworzyć szeroką gamę niestandardowych kafelków za pomocą funkcji adaptacyjnej.

Właściwości Typ Required Description
Dzieci IList<ITileBindingContentAdaptiveChild> false Elementy wizualizacji wbudowanej. Można dodać obiekty AdaptiveText, AdaptiveImage i AdaptiveGroup. Elementy podrzędne są wyświetlane w pionowym układzie StackPanel.
Obraz tła TileBackgroundImage false Opcjonalny obraz tła, który jest wyświetlany za całą zawartością kafelka, na całą szerokość.
PeekImage TilePeekImage false Opcjonalny obraz podglądu, który wsuwa się od góry kafelka.
TextStacking TileTextStacking false Określa układanie tekstu (wyrównanie w pionie) zawartości podrzędnej jako całości.

AdaptiveText

Element adaptacyjnego tekstu.

Właściwości Typ Required Description
Tekst ciąg false Tekst do wyświetlenia.
HintStyle AdaptiveTextStyle false Styl określa rozmiar czcionki, wagę i nieprzezroczystość tekstu.
HintWrap bool? false Ustaw wartość true, aby włączyć zawijanie tekstu. Wartość domyślna to false.
HintMaxLines int? false Maksymalna liczba wierszy, które element tekstowy może wyświetlić.
HintMinLines int? false Minimalna liczba wierszy, które musi wyświetlać element tekstowy.
HintAlign AdaptiveTextAlign false Wyrównanie tekstu w poziomie.
Language ciąg false Docelowa lokalizacja zawartości XML określona jako tagi języka BCP-47, takie jak "en-US" lub "fr-FR". Ustawienia regionalne określone tutaj zastępują każde inne określone ustawienia regionalne, takie jak w bindowaniu lub wizualizacji. Jeśli ta wartość jest dosłownym ciągiem znaków, ten atrybut domyślnie przyjmuje język interfejsu użytkownika. Jeśli ta wartość jest odwołaniem do ciągu znaków, ten atrybut domyślnie odnosi się do lokalizacji wybranej przez środowisko wykonawcze systemu Windows w procesie rozpoznawania ciągu znaków.

AdaptiveTextStyle

Styl tekstu określa rozmiar czcionki, wagę i nieprzezroczystość. Subtelna nieprzezroczystość wynosi 60%, a kod kolorystyczny to%.

Wartość Meaning
Wartość domyślna Wartość domyślna. Styl jest określany przez moduł renderowania.
Podpis Mniejszy od rozmiaru czcionki w akapicie.
CaptionSubtle Tak samo jak nagłówek, ale z subtelną przezroczystością.
Treść Rozmiar czcionki akapitu.
BodySubtle Tak samo jak Ciało, ale z subtelną nieprzezroczystością.
Base Rozmiar czcionki akapitu, pogrubiona waga. Zasadniczo pogrubiona wersja Body.
BaseSubtle Tak samo jak baza, ale z subtelną nieprzezroczystością.
Subtitle Rozmiar czcionki H4.
SubtitleSubtle Tak samo jak podtytuł, ale z subtelną nieprzezroczystością.
Title Rozmiar czcionki H3.
TitleSubtle Tak samo jak Tytuł, ale z subtelną nieprzezroczystością.
TitleNumeral Tak samo jak Tytuł, ale z usuniętymi marginesami u góry i u dołu.
Subheader Rozmiar czcionki H2.
SubheaderSubtle Taki sam jak Subheader, ale z subtelną nieprzezroczystością.
SubheaderNumeral Tak samo jak podtytuł, ale z usuniętym górnym i dolnym marginesem.
Nagłówek Rozmiar czcionki H1.
HeaderSubtle Tak samo jak nagłówek, ale z subtelną nieprzezroczystością.
HeaderNumeral Tak samo jak nagłówek, ale z górnym i dolnym marginesem usuniętym.

AdaptiveTextAlign

Określa wyrównanie tekstu w poziomie.

Wartość Meaning
Wartość domyślna Wartość domyślna. Wyrównanie jest automatycznie określane przez moduł renderowania.
Automatycznie Wyrównanie określone przez bieżący język i kulturę.
Left Wyrównaj tekst do lewej strony.
Center Wyrównaj tekst poziomo do środka.
Prawo Wyrównaj tekst w poziomie do prawej strony.

AdaptiveImage

Obraz w linii.

Właściwości Typ Required Description
Source ciąg prawda Adres URL obrazu. Obsługiwane są pliki ms-appx, ms-appdata i http. W ramach aktualizacji Fall Creators Update obrazy internetowe mogą mieć do 3 MB na zwykłych połączeniach i 1 MB w przypadku połączeń taryfowych. Na urządzeniach, na których nie uruchomiono jeszcze aktualizacji Fall Creators Update, obrazy internetowe nie mogą być większe niż 200 KB.
HintCrop AdaptiveImageCrop false Kontroluj żądane przycinanie obrazu.
HintRemoveMargin bool? false Domyślnie obrazy wewnątrz grup/podgrup mają margines 8 pikseli wokół nich. Ten margines można usunąć, ustawiając tę właściwość na true.
HintAlign AdaptiveImageAlign false Wyrównanie w poziomie obrazu.
Tekst alternatywny ciąg false Alternatywny tekst opisujący obraz używany do celów ułatwień dostępu.
AddImageQuery bool? false Ustaw wartość "true", aby umożliwić Windows dołączanie ciągu zapytania do adresu URL obrazu podanego w powiadomieniu kafelka. Użyj tego atrybutu, jeśli serwer hostuje obrazy i może obsługiwać ciągi zapytania, pobierając wariant obrazu na podstawie ciągów zapytania lub ignorując ciąg zapytania i zwracając obraz zgodnie z opisem bez ciągu zapytania. Ten ciąg zapytania określa skalę, ustawienie kontrastu i język; na przykład wartość "www.website.com/images/hello.png" podana w powiadomieniu staje się "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

AdaptiveImageCrop

Określa żądane przycinanie obrazu.

Wartość Meaning
Wartość domyślna Wartość domyślna. Zachowanie przycinania określone przez moduł renderowania.
Brak Obraz nie jest przycięty.
Circle Obraz jest przycinany do kształtu okręgu.

AdaptiveImageAlign

Określa wyrównanie w poziomie dla obrazu.

Wartość Meaning
Wartość domyślna Wartość domyślna. Zachowanie wyrównania określone przez moduł renderowania.
Stretch Obraz rozciąga się w celu wypełnienia dostępnej szerokości (i potencjalnie dostępnej wysokości również w zależności od miejsca umieszczenia obrazu).
Left Wyrównaj obraz do lewej strony, wyświetlając obraz w natywnej rozdzielczości.
Center Wyrównaj obraz poziomo na środku, wyświetlając obraz w jego natywnej rozdzielczości.
Prawo Wyrównaj obraz do prawej strony, wyświetlając obraz w natywnej rozdzielczości.

AdaptiveGroup

Grupy semantycznie identyfikują, że zawartość w grupie musi być wyświetlana jako całość lub nie jest wyświetlana, jeśli nie może pasować. Grupy umożliwiają również tworzenie wielu kolumn.

Właściwości Typ Required Description
Dzieci IList<AdaptiveSubgroup> false Podgrupy są wyświetlane jako kolumny pionowe. Należy użyć podgrup, aby udostępnić dowolną zawartość wewnątrz grupy adaptacyjnej.

AdaptiveSubgroup

Podgrupy to kolumny pionowe, które mogą zawierać tekst i obrazy.

Właściwości Typ Required Description
Dzieci <IListIAdaptiveSubgroupChild> false AdaptiveText i AdaptiveImage są prawidłowymi elementami podgrup.
HintWeight int? false Zarządzaj szerokością tej kolumny podgrupy, ustalając wagę względem innych podgrup.
HintTextStacking AdaptiveSubgroupTextStacking false Kontroluj pionowe wyrównanie zawartości tej podgrupy.

IAdaptiveSubgroupChild

Interfejs znacznikowy dla dzieci podgrupy.

Implementacje
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

TextStacking określa wyrównanie pionowe zawartości.

Wartość Meaning
Wartość domyślna Wartość domyślna. Program renderowany automatycznie wybiera domyślne wyrównanie w pionie.
Top Wyrównaj pionowo do góry.
Center Wyrównaj w pionie do środka.
Dół Wyrównaj pionowo do dołu.

TileBackgroundImage

Obraz tła wyświetlany na całej powierzchni kafelka.

Właściwości Typ Required Description
Source ciąg prawda Adres URL obrazu. Obsługiwane są ms-appx, ms-appdata i http(s). Obrazy HTTP muszą mieć rozmiar 200 KB lub mniejszy.
HintOverlay int? false Czarna nakładka na obraz tła. Ta wartość kontroluje nieprzezroczystość czarnej nakładki, gdzie 0 oznacza brak nakładki, a 100 oznacza całkowicie czarną nakładkę. Wartość domyślna to 20.
HintCrop TileBackgroundImageCrop false Nowość w wersji 1511: określ, jak chcesz, aby obraz miał zostać przycięty. W wersjach wcześniejszych niż 1511 zostanie to zignorowane, a obraz tła zostanie wyświetlony bez przycinania.
Tekst alternatywny ciąg false Alternatywny tekst opisujący obraz używany do celów ułatwień dostępu.
AddImageQuery bool? false Ustaw wartość "true", aby umożliwić Windows dołączanie ciągu zapytania do adresu URL obrazu podanego w powiadomieniu kafelka. Użyj tego atrybutu, jeśli serwer hostuje obrazy i może obsługiwać ciągi zapytania, pobierając wariant obrazu na podstawie ciągów zapytania lub ignorując ciąg zapytania i zwracając obraz zgodnie z opisem bez ciągu zapytania. Ten ciąg zapytania określa skalę, ustawienie kontrastu i język; na przykład wartość "www.website.com/images/hello.png" podana w powiadomieniu staje się "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TileBackgroundImageCrop

Steruje przycinaniem obrazu tła.

Wartość Meaning
Wartość domyślna Przycinanie używa domyślnego zachowania modułu renderowania.
Brak Obraz nie jest przycięty, wyświetlany jest w formacie kwadratu.
Circle Obraz jest przycięty do okręgu.

TilePeekImage

Obraz podglądu wysuwający się z góry kafelka.

Właściwości Typ Required Description
Source ciąg prawda Adres URL obrazu. Obsługiwane są pliki ms-appx, ms-appdata i http(s). Obrazy HTTP muszą mieć rozmiar 200 KB lub mniejszy.
HintOverlay int? false Nowa w 1511: czarna nakładka na obraz podglądu. Ta wartość kontroluje nieprzezroczystość czarnej nakładki, a 0 oznacza brak nakładki, a 100 oznacza całkowicie czarną nakładkę. Wartość domyślna to 20. W poprzednich wersjach ta wartość jest ignorowana i obraz podglądu jest wyświetlany z nakładką 0.
HintCrop TilePeekImageCrop false Nowość w wersji 1511: określ, jak chcesz, aby obraz został przycięty. W wersjach wcześniejszych niż 1511 będzie to ignorowane i będzie wyświetlany obraz podglądu bez przycinania.
Tekst alternatywny ciąg false Alternatywny tekst opisujący obraz używany do celów ułatwień dostępu.
AddImageQuery bool? false Ustaw wartość "true", aby umożliwić Windows dołączanie ciągu zapytania do adresu URL obrazu podanego w powiadomieniu kafelka. Użyj tego atrybutu, jeśli serwer hostuje obrazy i może obsługiwać ciągi zapytania, pobierając wariant obrazu na podstawie ciągów zapytania lub ignorując ciąg zapytania i zwracając obraz zgodnie z opisem bez ciągu zapytania. Ten ciąg zapytania określa skalę, ustawienie kontrastu i język; na przykład wartość "www.website.com/images/hello.png" podana w powiadomieniu staje się "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TilePeekImageCrop

Steruje przycinaniem obrazu podglądu.

Wartość Meaning
Wartość domyślna Przycinanie używa domyślnego zachowania modułu renderowania.
Brak Obraz nie jest przycięty, wyświetlany jest w formacie kwadratu.
Circle Obraz jest przycięty do okręgu.

TileTextStacking

Układanie tekstu określa wyrównanie w pionie zawartości.

Wartość Meaning
Wartość domyślna Wartość domyślna. Program renderowany automatycznie wybiera domyślne wyrównanie w pionie.
Top Wyrównaj pionowo do góry.
Center Wyrównaj w pionie do środka.
Dół Wyrównaj pionowo do dołu.

TileBindingContentIconic

Obsługiwane w przypadku małych i średnich. Włącza szablon kafelka z ikoną, w którym można wyświetlić ikonę i znaczek obok siebie na kafelku. Numer obok ikony jest wyświetlany za pomocą oddzielnego powiadomienia w formie plakietki.

Właściwości Typ Required Description
Ikona TileBasicImage prawda Aby obsługiwać co najmniej kafelki Desktop i Mobile oraz Small i Medium, zapewnij obraz o kwadratowych proporcjach o rozdzielczości 200x200, w formacie PNG, z przezroczystością i bez żadnego koloru innego niż biały. Aby uzyskać więcej informacji, zobacz: Specjalne szablony kafelków.

TileBindingContentContact

Tylko na urządzeniach mobilnych. Obsługiwane w przypadku małych, średnich i dużych.

Właściwości Typ Required Description
Obraz TileBasicImage prawda Obraz do wyświetlenia.
Tekst TileBasicText false Wyświetlany wiersz tekstu. Nie jest wyświetlany na małym kafelku.

TileBindingContentPeople

Nowość w wersji 1511: obsługiwana w układach Średni, Szeroki i Duży (komputery stacjonarne i urządzenia mobilne). Wcześniej była to tylko wersja mobilna i tylko średnia i szeroka.

Właściwości Typ Required Description
Images IList<TileBasicImage> prawda Obrazy, które będą poruszać się po okręgu.

TileBindingContentPhotos

Przechodzi przez pokaz slajdów zdjęć. Obsługiwane we wszystkich rozmiarach.

Właściwości Typ Required Description
Images IList<TileBasicImage> prawda Można udostępnić maksymalnie 12 obrazów (na urządzeniach przenośnych będzie wyświetlanych maksymalnie 9), które będą używane do pokazu slajdów. Dodanie więcej niż 12 spowoduje zgłoszenie wyjątku.

TileBasicImage

Obraz używany na różnych specjalnych szablonach.

Właściwości Typ Required Description
Source ciąg prawda Adres URL obrazu. Obsługiwane są pliki ms-appx, ms-appdata i http(s). Obrazy HTTP muszą mieć rozmiar 200 KB lub mniejszy.
Tekst alternatywny ciąg false Alternatywny tekst opisujący obraz używany do celów ułatwień dostępu.
AddImageQuery bool? false Ustaw wartość "true", aby umożliwić Windows dołączanie ciągu zapytania do adresu URL obrazu podanego w powiadomieniu kafelka. Użyj tego atrybutu, jeśli serwer hostuje obrazy i może obsługiwać ciągi zapytania, pobierając wariant obrazu na podstawie ciągów zapytania lub ignorując ciąg zapytania i zwracając obraz zgodnie z opisem bez ciągu zapytania. Ten ciąg zapytania określa skalę, ustawienie kontrastu i język; na przykład wartość "www.website.com/images/hello.png" podana w powiadomieniu staje się "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TileBasicText

Podstawowy element tekstowy używany w różnych szablonach specjalnych.

Właściwości Typ Required Description
Tekst ciąg false Tekst do wyświetlenia.
Language ciąg false Docelowa lokalizacja zawartości XML określona jako tagi języka BCP-47, takie jak "en-US" lub "fr-FR". Ustawienia regionalne określone tutaj zastępują każde inne określone ustawienia regionalne, takie jak w bindowaniu lub wizualizacji. Jeśli ta wartość jest dosłownym ciągiem znaków, ten atrybut domyślnie przyjmuje język interfejsu użytkownika. Jeśli ta wartość jest odwołaniem do ciągu znaków, ten atrybut domyślnie odnosi się do lokalizacji wybranej przez środowisko wykonawcze systemu Windows w procesie rozpoznawania ciągu znaków.
  • Ostatnia aktualizacja o