Windows atlama listesine öğe ekleme

Atlama listesi, Windows kullanıcı görev çubuğunda veya Başlat menüsünde uygulamanızın simgesine sağ tıkladığında görüntülenen kısayol menüsüdür. Atlama listesini görevlerle (yeni ileti oluşturma veya ayarları açma gibi uygulama genelindeki hızlı eylemler) ve son projeler veya sabitlenmiş belgeler gibi özel öğe gruplarıyla doldurabilirsiniz.

WinUI Galeri uygulamasını açın ve JumpList'in nasıl çalıştığını görün

Important

JumpList API'sinde paket kimliği gerekir. Paketlenmiş (MSIX) uygulamalarda ve dış konumla paketlenmiş uygulamalarda çalışır, ancak paketlenmemiş uygulamalarda kullanılamaz.

Prerequisites

  • Uygulamanızın paket kimliği olmalıdır: MSIX ile paketlenmiş veya dış konumla paketlenmiş. Paketlenmemiş uygulamalar desteklenmez.
  • Hedef Windows 10, sürüm 1607 (Yıldönümü Güncelleştirmesi, derleme 14393) veya üzeri.

Mevcut atlama listesini yükle

Öğeleri eklemeden veya kaldırmadan önce JumpList.LoadCurrentAsync'i çağırarak uygulamanın geçerli atlama listesini yükleyin:

using Windows.UI.StartScreen;

var jumpList = await JumpList.LoadCurrentAsync();

Görev ekleme

Görevler, boş GroupName özelliği olan öğelerdir. Windows bunları atlama listesinin en altındaki yerleşik Görevler bölümüne yerleştirir. Bağlam ne olursa olsun her zaman ilgili olan yaygın eylemler için görevleri kullanın.

JumpListItem.CreateWithArguments ile bir görev oluşturun, bunu Items koleksiyonuna ekleyin ve ardından JumpList.SaveAsync öğesini çağırarak kaydedin. Kullanıcı görevi seçtiğinde Windows, uygulamanızı sağladığınız bağımsız değişken dizesiyle başlatır; bu dizeyi başlangıçta etkinleştirme bağımsız değişkenlerinden okuyabilirsiniz.

var jumpList = await JumpList.LoadCurrentAsync();

var task = JumpListItem.CreateWithArguments("/compose", "New Message");
task.Description = "Compose a new message";
task.Logo = new Uri("ms-appx:///Assets/Tiles/AppList.targetsize-48.png");

jumpList.Items.Add(task);
await jumpList.SaveAsync();

Özel gruba öğe ekleme

Özel gruplar, ilgili öğeleri adlandırılmış bir başlık altında düzenlemenize olanak sağlar. GroupName özelliğini boş olmayan bir dize olarak ayarlayın; aynı GroupName öğeyi paylaşan tüm öğeler bu başlığın altında birlikte görünür.

var jumpList = await JumpList.LoadCurrentAsync();

var item = JumpListItem.CreateWithArguments("/project-alpha", "Project Alpha");
item.GroupName = "Projects";
item.Description = "Open Project Alpha";
item.Logo = new Uri("ms-appx:///Assets/Tiles/AppList.targetsize-48.png");

jumpList.Items.Add(item);
await jumpList.SaveAsync();

Tüm öğeleri temizle

Eklediğiniz tüm öğeleri kaldırmak için, kaydetmeden önce Items koleksiyonunu temizleyin:

var jumpList = await JumpList.LoadCurrentAsync();
jumpList.Items.Clear();
await jumpList.SaveAsync();

Windows, bu çağrıdan bağımsız olarak sistem tarafından yönetilen bölümleri (En Son ve Sık Kullanılanlar gibi) korur; yalnızca özel görevleriniz ve gruplarınız temizlenir.

  • Last updated on