SecondaryTile Konstruktor

Definisi

Ruang nama:

Windows.UI.StartScreen

Overload

SecondaryTile()	Membuat objek SecondaryTile . Pemanggil kemudian harus mengatur properti wajib apa pun melalui objek sebelum mencoba menyematkan, memperbarui, atau menghapus ubin. Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.
SecondaryTile(String)	Membuat objek SecondaryTile dengan ID tertentu. Bentuk konstruktor ini harus digunakan untuk membuat objek petak peta sekunder untuk melakukan pembaruan atau penghapusan petak peta. Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.
SecondaryTile(String, String, String, Uri, TileSize)	Membuat objek SecondaryTile yang menyertakan semua properti wajib yang diperlukan untuk membuat petak peta sedang. Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.
SecondaryTile(String, String, String, String, TileOptions, Uri)	Catatan Konstruktor ini dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize). Membuat objek SecondaryTile sebagai petak peta sedang. Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.
SecondaryTile(String, String, String, String, TileOptions, Uri, Uri)	Catatan Konstruktor ini dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) dan berikan ukuran dan opsi petak peta lainnya melalui metode SecondaryTile.VisualElements . Membuat objek SecondaryTile sebagai petak peta yang lebar. Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow. Di Windows Phone 8.1, semua petak peta—termasuk petak sekunder—disematkan sebagai petak peta sedang, setelah itu petak peta dapat diubah ukurannya oleh pengguna. Konstruktor ini menyediakan opsi mengubah ukuran ke petak peta yang lebar.

SecondaryTile()

Membuat objek SecondaryTile . Pemanggil kemudian harus mengatur properti wajib apa pun melalui objek sebelum mencoba menyematkan, memperbarui, atau menghapus ubin.

Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.

public:
 SecondaryTile();

 SecondaryTile();

public SecondaryTile();

function SecondaryTile()

Public Sub New ()

Keterangan

Properti petak peta wajib, seperti nama tampilan, harus diatur melalui panggilan ke metode lain dari kelas ini sebelum petak peta dapat diaktifkan.

SecondaryTile(String)

Membuat objek SecondaryTile dengan ID tertentu. Bentuk konstruktor ini harus digunakan untuk membuat objek petak peta sekunder untuk melakukan pembaruan atau penghapusan petak peta.

Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.

public:
 SecondaryTile(Platform::String ^ tileId);

 SecondaryTile(winrt::hstring const& tileId);

public SecondaryTile(string tileId);

function SecondaryTile(tileId)

Public Sub New (tileId As String)

Parameter

tileId

String

Platform::String

winrt::hstring

String yang akan mengidentifikasi petak peta secara unik dalam aplikasi Anda. Pilih ID unik yang deskriptif dan bermakna untuk aplikasi Anda. Jika Anda memberikan ID yang sama dengan petak peta sekunder yang ada, petak peta sekunder yang ada akan ditimpa.

Keterangan

ID unik yang Anda gunakan untuk membuat petak peta ini dapat digunakan nanti untuk memperbarui atau menghapusnya.

Properti petak peta wajib lainnya, seperti nama tampilan, harus diatur melalui panggilan ke metode lain dari kelas ini sebelum petak peta dapat diaktifkan.

SecondaryTile(String, String, String, Uri, TileSize)

Membuat objek SecondaryTile yang menyertakan semua properti wajib yang diperlukan untuk membuat petak peta sedang.

Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.

public:
 SecondaryTile(Platform::String ^ tileId, Platform::String ^ displayName, Platform::String ^ arguments, Uri ^ square150x150Logo, TileSize desiredSize);

 SecondaryTile(winrt::hstring const& tileId, winrt::hstring const& displayName, winrt::hstring const& arguments, Uri const& square150x150Logo, TileSize const& desiredSize);

public SecondaryTile(string tileId, string displayName, string arguments, System.Uri square150x150Logo, TileSize desiredSize);

function SecondaryTile(tileId, displayName, arguments, square150x150Logo, desiredSize)

Public Sub New (tileId As String, displayName As String, arguments As String, square150x150Logo As Uri, desiredSize As TileSize)

Parameter

tileId

String

Platform::String

winrt::hstring

String yang akan mengidentifikasi petak peta secara unik dalam paket aplikasi Anda. Pilih ID unik yang deskriptif dan bermakna untuk aplikasi Anda. Ini dibatasi hingga 64 karakter dan harus dimulai dengan angka atau huruf dan terdiri dari karakter a-z, A-Z, 0-9, titik (.), atau garis bawah (_). Jika Anda memberikan ID yang sama dengan petak peta sekunder yang ada, petak peta sekunder yang ada akan ditimpa. Dapat diatur atau diambil melalui properti TileId .

displayName

String

Platform::String

winrt::hstring

Nama yang akan ditampilkan pada petak peta, di tipsalat petak peta, dan saat menampilkan petak peta kecil, seperti di layar Aplikasi atau hasil pencarian. String ini setara dengan nama tampilan yang diberikan dalam manifes untuk petak utama. Ini dibatasi hingga 256 karakter, tetapi dalam praktiknya harus tetap pendek untuk menghindari pemotongan. Nilai ini dapat diatur atau diambil melalui properti DisplayName .

Nama tampilan hanya ditampilkan pada petak sekunder lebar pada Windows Phone 8.1.

arguments

String

Platform::String

winrt::hstring

String yang ditentukan aplikasi yang bermakna untuk aplikasi panggilan. String argumen ini diteruskan kembali ke aplikasi saat aplikasi diaktifkan dari petak sekunder. Ini akan dipotong setelah 2048 karakter. Dapat diatur atau diambil melalui properti Argumen .

Catatan

Parameter ini harus dikodekan URL untuk aplikasi Windows Phone Silverlight 8.1. Semua jenis aplikasi lainnya dapat menggunakan strukturnya sendiri.

square150x150Logo

Uri Uri

Referensi ke gambar logo sedang yang disimpan di Pengidentifikasi Sumber Daya Seragam (URI). Dapat diatur atau diambil melalui properti SecondaryTileVisualElements.Square150x150Logo . Nilai ini dapat diekspresikan menggunakan salah satu skema ini: jalur ms-appx:/// A dalam paket aplikasi yang disebarkan. Jalur ini diselesaikan untuk bahasa dan dataran tinggi DPI yang didukung oleh aplikasi.File ms-appdata:///local/ A ditemukan di penyimpanan aplikasi per pengguna.

desiredSize

TileSize

Ukuran petak peta yang akan disematkan. Nilai ini harus Default (yang menyediakan perilaku Windows 8), Square150x150, atau Wide310x150. Nilai TileSize lainnya menyebabkan pengecualian dilemparkan selama runtime.

Parameter desiredSize diabaikan pada Windows Phone 8.1. Di ponsel, semua petak peta— termasuk petak sekunder— disematkan sebagai petak peta sedang, setelah itu petak peta dapat diubah ukurannya oleh pengguna.

SecondaryTile(String, String, String, String, TileOptions, Uri)

Catatan

Konstruktor ini dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize).

Membuat objek SecondaryTile sebagai petak peta sedang.

Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.

public:
 SecondaryTile(Platform::String ^ tileId, Platform::String ^ shortName, Platform::String ^ displayName, Platform::String ^ arguments, TileOptions tileOptions, Uri ^ logoReference);

/// [Windows.Foundation.Metadata.Deprecated("SecondaryTile(string, string, string, string, Windows.UI.StartScreen.TileOptions, Windows.Foundation.Uri) may be altered or unavailable for releases after Windows Phone 8.1. Instead, use SecondaryTile(string, string, string, Windows.Foundation.Uri, Windows.UI.StartScreen.TileSize).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
 SecondaryTile(winrt::hstring const& tileId, winrt::hstring const& shortName, winrt::hstring const& displayName, winrt::hstring const& arguments, TileOptions const& tileOptions, Uri const& logoReference);

[Windows.Foundation.Metadata.Deprecated("SecondaryTile(string, string, string, string, Windows.UI.StartScreen.TileOptions, Windows.Foundation.Uri) may be altered or unavailable for releases after Windows Phone 8.1. Instead, use SecondaryTile(string, string, string, Windows.Foundation.Uri, Windows.UI.StartScreen.TileSize).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
public SecondaryTile(string tileId, string shortName, string displayName, string arguments, TileOptions tileOptions, System.Uri logoReference);

function SecondaryTile(tileId, shortName, displayName, arguments, tileOptions, logoReference)

Public Sub New (tileId As String, shortName As String, displayName As String, arguments As String, tileOptions As TileOptions, logoReference As Uri)

Parameter

tileId

String

Platform::String

winrt::hstring

String yang akan mengidentifikasi petak peta secara unik dalam paket aplikasi Anda. Pilih ID unik yang deskriptif dan bermakna untuk aplikasi Anda. Ini dibatasi hingga 64 karakter dan harus dimulai dengan angka atau huruf dan terdiri dari karakter a-z, A-Z, 0-9, titik (.), atau garis bawah (_). Jika Anda memberikan ID yang sama dengan petak peta sekunder yang ada, petak peta sekunder yang ada akan ditimpa. Dapat diatur atau diambil melalui properti TileId .

shortName

String

Platform::String

winrt::hstring

Nama pendek untuk ditampilkan langsung di petak jika aplikasi memilih untuk melakukannya. Apa pun yang lebih dari 40 karakter akan dipotong. Pengguna memiliki opsi untuk mengubah nilai ini sebagai bagian dari proses penyematan. Dapat diatur atau diambil melalui properti ShortName .

Catatan

Nilai ini hanya digunakan di Windows 8 dan tidak digunakan lagi demi displayName di versi yang lebih baru.

displayName

String

Platform::String

winrt::hstring

Nama yang akan ditampilkan pada petak peta, di tipsalat petak peta, dan saat menampilkan petak peta kecil, seperti di layar Aplikasi atau hasil pencarian. String ini setara dengan nama tampilan yang diberikan dalam manifes untuk petak utama. Ini dibatasi hingga 256 karakter, tetapi dalam praktiknya harus tetap pendek untuk menghindari pemotongan. Nilai ini dapat diatur atau diambil melalui properti DisplayName .

Nama tampilan hanya ditampilkan pada petak sekunder lebar pada Windows Phone 8.1.

arguments

String

Platform::String

winrt::hstring

String yang ditentukan aplikasi yang bermakna untuk aplikasi panggilan. String argumen ini diteruskan kembali ke aplikasi saat aplikasi diaktifkan dari petak sekunder. Ini akan dipotong setelah 2048 karakter. Dapat diatur atau diambil melalui properti Argumen .

tileOptions

TileOptions

Nilai yang menentukan berbagai opsi seperti apakah nama akan ditampilkan pada petak sekunder. Dapat diatur atau diambil melalui properti TileOptions .

logoReference

Uri Uri

Referensi ke gambar logo persegi yang disimpan di Pengidentifikasi Sumber Daya Seragam (URI). Dapat diatur atau diambil melalui properti Logo . Nilai ini dapat diekspresikan menggunakan salah satu skema ini: jalur ms-appx:/// A dalam paket aplikasi yang disebarkan. Jalur ini diselesaikan untuk bahasa dan dataran tinggi DPI yang didukung oleh aplikasi.File ms-appdata:///local/ A ditemukan di penyimpanan aplikasi per pengguna.

Atribut

DeprecatedAttribute

SecondaryTile(String, String, String, String, TileOptions, Uri, Uri)

Catatan

Konstruktor ini dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) dan berikan ukuran dan opsi petak peta lainnya melalui metode SecondaryTile.VisualElements .

Membuat objek SecondaryTile sebagai petak peta yang lebar.

Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.

Di Windows Phone 8.1, semua petak peta—termasuk petak sekunder—disematkan sebagai petak peta sedang, setelah itu petak peta dapat diubah ukurannya oleh pengguna. Konstruktor ini menyediakan opsi mengubah ukuran ke petak peta yang lebar.

public:
 SecondaryTile(Platform::String ^ tileId, Platform::String ^ shortName, Platform::String ^ displayName, Platform::String ^ arguments, TileOptions tileOptions, Uri ^ logoReference, Uri ^ wideLogoReference);

/// [Windows.Foundation.Metadata.Deprecated("SecondaryTile(string, string, string, string, Windows.UI.StartScreen.TileOptions, Windows.Foundation.Uri, Windows.Foundation.Uri) may be altered or unavailable for releases after Windows Phone 8.1. Instead, use SecondaryTile(string, string, string, Windows.Foundation.Uri, Windows.UI.StartScreen.TileSize).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
 SecondaryTile(winrt::hstring const& tileId, winrt::hstring const& shortName, winrt::hstring const& displayName, winrt::hstring const& arguments, TileOptions const& tileOptions, Uri const& logoReference, Uri const& wideLogoReference);

[Windows.Foundation.Metadata.Deprecated("SecondaryTile(string, string, string, string, Windows.UI.StartScreen.TileOptions, Windows.Foundation.Uri, Windows.Foundation.Uri) may be altered or unavailable for releases after Windows Phone 8.1. Instead, use SecondaryTile(string, string, string, Windows.Foundation.Uri, Windows.UI.StartScreen.TileSize).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
public SecondaryTile(string tileId, string shortName, string displayName, string arguments, TileOptions tileOptions, System.Uri logoReference, System.Uri wideLogoReference);

function SecondaryTile(tileId, shortName, displayName, arguments, tileOptions, logoReference, wideLogoReference)

Public Sub New (tileId As String, shortName As String, displayName As String, arguments As String, tileOptions As TileOptions, logoReference As Uri, wideLogoReference As Uri)

Parameter

tileId

String

Platform::String

winrt::hstring

String yang akan mengidentifikasi petak peta secara unik dalam paket aplikasi Anda. Pilih ID unik yang deskriptif dan bermakna untuk aplikasi Anda. Ini dibatasi hingga 64 karakter dan harus dimulai dengan angka atau huruf dan terdiri dari karakter a-z, A-Z, 0-9, titik (.), atau garis bawah (_). Jika Anda memberikan ID yang sama dengan petak peta sekunder yang ada, petak peta sekunder yang ada akan ditimpa. Dapat diatur atau diambil melalui properti TileId .

shortName

String

Platform::String

winrt::hstring

Nama pendek untuk ditampilkan langsung di petak jika aplikasi memilih untuk melakukannya. Apa pun yang lebih dari 40 karakter akan dipotong. Pengguna memiliki opsi untuk mengubah nilai ini sebagai bagian dari proses penyematan. Dapat diatur atau diambil melalui properti ShortName .

Catatan

Nilai ini hanya digunakan di Windows 8 dan tidak digunakan lagi demi displayName di versi yang lebih baru.

displayName

String

Platform::String

winrt::hstring

Nama yang akan ditampilkan pada petak peta, di tipsalat petak peta, dan saat menampilkan petak peta kecil, seperti di layar Aplikasi atau hasil pencarian. String ini setara dengan nama tampilan yang diberikan dalam manifes untuk petak utama. Ini dibatasi hingga 256 karakter, tetapi dalam praktiknya harus tetap pendek untuk menghindari pemotongan. Nilai ini dapat diatur atau diambil melalui properti DisplayName .

Nama tampilan hanya ditampilkan pada petak sekunder lebar pada Windows Phone 8.1.

arguments

String

Platform::String

winrt::hstring

String yang ditentukan aplikasi yang bermakna untuk aplikasi panggilan. String argumen ini diteruskan kembali ke aplikasi saat aplikasi diaktifkan dari petak sekunder. Ini akan dipotong setelah 2048 karakter. Dapat diatur atau diambil melalui properti Argumen .

tileOptions

TileOptions

Nilai yang menentukan berbagai opsi seperti apakah nama akan ditampilkan pada petak sekunder. Dapat diatur atau diambil melalui properti TileOptions .

logoReference

Uri Uri

Referensi ke gambar logo sedang yang disimpan di Pengidentifikasi Sumber Daya Seragam (URI). Dapat diatur atau diambil melalui properti Square150x150Logo . Nilai ini dapat diekspresikan menggunakan salah satu skema ini: jalur ms-appx:/// A dalam paket aplikasi yang disebarkan. Jalur ini diselesaikan untuk bahasa dan dataran tinggi DPI yang didukung oleh aplikasi.File ms-appdata:///local/ A ditemukan di penyimpanan aplikasi per pengguna.

wideLogoReference

Uri Uri

Referensi ke gambar logo lebar yang disimpan di Pengidentifikasi Sumber Daya Seragam (URI). Dapat diatur atau diambil melalui properti WideLogo . Nilai ini dapat diekspresikan menggunakan salah satu skema ini: jalur ms-appx:/// A dalam paket aplikasi yang disebarkan. Jalur ini diselesaikan untuk bahasa dan dataran tinggi DPI yang didukung oleh aplikasi.File ms-appdata:///local/ A ditemukan di penyimpanan aplikasi per pengguna.

Atribut

DeprecatedAttribute