JumpList Sınıf

Tanım

Ad Alanı:

System.Windows.Shell

Bütünleştirilmiş Kod:

PresentationFramework.dll

Windows 7 görev çubuğu düğmesinde menü olarak görüntülenen öğelerin ve görevlerin listesini temsil eder.

public ref class JumpList sealed : System::ComponentModel::ISupportInitialize

[System.Windows.Markup.ContentProperty("JumpItems")]
public sealed class JumpList : System.ComponentModel.ISupportInitialize

[<System.Windows.Markup.ContentProperty("JumpItems")>]
type JumpList = class
    interface ISupportInitialize

Public NotInheritable Class JumpList
Implements ISupportInitialize

Devralma

Object

JumpList

Öznitelikler

ContentPropertyAttribute

Uygulamalar

ISupportInitialize

Örnekler

Aşağıdaki örnekte Atlama Listesi içeren bir uygulama gösterilmektedir. Uygulamada, geçerli Atlama Listesine görev eklemenize, Atlama Listesi içeriğini temizlemenize ve uygulamaya yeni bir Atlama Listesi uygulamanıza olanak tanıyan üç düğme vardır.

Aşağıdaki örnekte, işaretleme içinde bildiriminin JumpList nasıl yapıldığını gösterilmektedir. iki JumpListJumpTask bağlantı ve bir JumpPathiçerir. JumpPath uygulama .txt dosya adı uzantısını işlemek üzere kaydedilmediyse, kabuk uygulama başarısız olur.

<Application x:Class="JumpListSample.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             StartupUri="MainWindow.xaml">
    <JumpList.JumpList>
        <JumpList ShowRecentCategory="True"
                  ShowFrequentCategory="True"
                  JumpItemsRejected="JumpList_JumpItemsRejected"
                  JumpItemsRemovedByUser="JumpList_JumpItemsRemovedByUser">
            <JumpTask Title="Notepad" 
                      Description="Open Notepad." 
                      ApplicationPath="C:\Windows\notepad.exe"
                      IconResourcePath="C:\Windows\notepad.exe"/>
            <JumpTask Title="Read Me" 
                      Description="Open readme.txt in Notepad." 
                      ApplicationPath="C:\Windows\notepad.exe"
                      IconResourcePath="C:\Windows\System32\imageres.dll"
                      IconResourceIndex="14"
                      WorkingDirectory="C:\Users\Public\Documents"
                      Arguments="readme.txt"/>
            <JumpPath Path="C:\Users\Public\Documents\readme.txt" />
        </JumpList>
    </JumpList.JumpList>
</Application>

Aşağıdaki örnekte için App.xamlarka planda kod sayfası gösterilmektedir. Bu kod ve JumpItemsRejected olaylarını JumpItemsRemovedByUser işler.

using System.Text;
using System.Windows;
using System.Windows.Shell;

namespace JumpListSample
{
    /// <summary>
    /// Interaction logic for App.xaml
    /// </summary>
    public partial class App : Application
    {
        private void JumpList_JumpItemsRejected(object sender, System.Windows.Shell.JumpItemsRejectedEventArgs e)
        {
            StringBuilder sb = new StringBuilder();
            sb.AppendFormat("{0} Jump Items Rejected:\n", e.RejectionReasons.Count);
            for (int i = 0; i < e.RejectionReasons.Count; ++i)
            {
                if (e.RejectedItems[i].GetType() == typeof(JumpPath))
                    sb.AppendFormat("Reason: {0}\tItem: {1}\n", e.RejectionReasons[i], ((JumpPath)e.RejectedItems[i]).Path);
                else
                    sb.AppendFormat("Reason: {0}\tItem: {1}\n", e.RejectionReasons[i], ((JumpTask)e.RejectedItems[i]).ApplicationPath);
            }

            MessageBox.Show(sb.ToString());
        }

        private void JumpList_JumpItemsRemovedByUser(object sender, System.Windows.Shell.JumpItemsRemovedEventArgs e)
        {
            StringBuilder sb = new StringBuilder();
            sb.AppendFormat("{0} Jump Items Removed by the user:\n", e.RemovedItems.Count);
            for (int i = 0; i < e.RemovedItems.Count; ++i)
            {
                sb.AppendFormat("{0}\n", e.RemovedItems[i]);
            }

            MessageBox.Show(sb.ToString());
        }
    }
}

Aşağıdaki örnek, uygulama kullanıcı arabirimini oluşturmak için kullanılan işaretlemeyi gösterir.

<Window x:Class="JumpListSample.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Jump List Sample" Height="240" Width="500">
    <Window.Resources>
        <Style TargetType="Button">
            <Setter Property="Width" Value="200" />
            <Setter Property="Margin" Value="5" />
        </Style>
    </Window.Resources>
    <Grid>
        <StackPanel>
            <Button Content="Add Task to JumpList" Click="AddTask" />
            <Button Content="Clear Jump List" Click="ClearJumpList"/>
            <Button Content="Set New Jump List" Click="SetNewJumpList" />
        </StackPanel>
    </Grid>
</Window>

Aşağıdaki örnekte için MainWindow.xamlarka planda kod sayfası gösterilmektedir. Bu kod, yordam kodunda değiştirme, temizleme ve oluşturma JumpList adımlarını gösterir. Yeni Atlama Listesi için statik SetJumpList yöntemi, JumpList geçerli uygulamayla ilişkilendirmek ve Windows kabuğuna JumpList uygulamak için çağrılır.

using System;
using System.IO;
using System.Windows;
using System.Windows.Shell;

namespace JumpListSample
{
    /// <summary>
    /// Interaction logic for MainWindow.xaml
    /// </summary>
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }
        private void AddTask(object sender, RoutedEventArgs e)
        {
            // Configure a new JumpTask.
            JumpTask jumpTask1 = new JumpTask();
            // Get the path to Calculator and set the JumpTask properties.
            jumpTask1.ApplicationPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.SystemX86), "calc.exe");
            jumpTask1.IconResourcePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.SystemX86), "calc.exe");
            jumpTask1.Title = "Calculator";
            jumpTask1.Description = "Open Calculator.";
            jumpTask1.CustomCategory = "User Added Tasks";
            // Get the JumpList from the application and update it.
            JumpList jumpList1 = JumpList.GetJumpList(App.Current);
            jumpList1.JumpItems.Add(jumpTask1);
            JumpList.AddToRecentCategory(jumpTask1);
            jumpList1.Apply();
        }
        private void ClearJumpList(object sender, RoutedEventArgs e)
        {
            JumpList jumpList1 = JumpList.GetJumpList(App.Current);
            jumpList1.JumpItems.Clear();
            jumpList1.Apply();
        }
        private void SetNewJumpList(object sender, RoutedEventArgs e)
        {
            //Configure a new JumpTask
            JumpTask jumpTask1 = new JumpTask();
            // Get the path to WordPad and set the JumpTask properties.
            jumpTask1.ApplicationPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.System), "write.exe");
            jumpTask1.IconResourcePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.System), "write.exe");
            jumpTask1.Title = "WordPad";
            jumpTask1.Description = "Open WordPad.";
            jumpTask1.CustomCategory = "Jump List 2";
            // Create and set the new JumpList.
            JumpList jumpList2 = new JumpList();
            jumpList2.JumpItems.Add(jumpTask1);
            JumpList.SetJumpList(App.Current, jumpList2);
        }
    }
}

Açıklamalar

Windows 7 görev çubuğu, atlama listelerini kullanarak doğrudan görev çubuğu düğmesinden programları başlatmak için gelişmiş işlevsellik sağlar. Atlama Listeleri Windows 7 Başlat menüsünde de kullanılır. Görev çubuğu düğmesine sağ tıklayarak veya Başlat menüsünde bir programın yanındaki oka tıklayarak Atlama Listesi'ne erişebilirsiniz. Atlama Listeleri hakkında daha fazla bilgi için Windows Kullanıcı Deneyimi Etkileşim Yönergeleri'nin Taskbar bölümüne bakın.

JumpList sınıfı, Windows 7 görev çubuğundaki Atlama Listesi işlevselliği için yönetilen bir sarmalayıcı sağlar ve Windows kabuğuna geçirilen verileri yönetir. JumpList sınıfı tarafından sunulan işlevsellik, Windows 7 önceki Windows sürümlerinde kullanılamaz. JumpList sınıfını kullanan uygulamalar diğer Windows sürümlerinde çalışır, ancak Atlama Listesi kullanılamaz. Windows kabuğu ve yerel Atlama Listesi API'leri hakkında daha fazla bilgi için bkz. Taskbar Extensions.

Aşağıdaki çizimde, Tasks ve Frequent kategorilerindeki öğelerle Windows Media Player için Atlama Listesi gösterilmektedir.

Windows Media Player Atlama Listesi

Atlama Listesi Yapılandırma

Atlama Listeleri, bir JumpTask ve JumpPatholmak üzere iki tür öğe içerebilir. A JumpTask , bir programın bağlantısı ve bir JumpPath dosyanın bağlantısıdır. Ve JumpTask belirtilmemiş Title bir CustomCategory öğe oluşturarak Atlama Listesi'ndeki öğeleri görsel olarak ayırabilirsiniz. Bu boş JumpTask , Atlama Listesi'nde yatay çizgi olarak görüntülenir.

Note

içinde JumpPath belirtilen dosyanın türü uygulamanıza kayıtlı değilse, dosya Atlama Listesinde görünmez. Örneğin, bir .txt dosyasına işaret eden bir eklerseniz JumpPath uygulamanızın .txt dosyaları işlemek için kaydedilmesi gerekir. Daha fazla bilgi için bkz. Dosya İlişkilendirmelerine Giriş.

Atlama öğeleri içindeki JumpListkategorilere yerleştirilir. Varsayılan olarak, JumpItem kategorisinde bir görüntülenir. Alternatif olarak, için CustomCategorybir JumpItem belirtebilirsiniz.

ve özelliklerini ayarlayarak içinde standart Son ve JumpList kullanılan kategorilerin görüntülenip görüntülenmeyeceğini ShowRecentCategoryShowFrequentCategory belirtebilirsiniz. Bu kategorilerin içeriği Windows kabuğu tarafından yönetilir. Bu kategoriler aynı verilerin büyük bir kısmını içerebileceğinden, genellikle içinde JumpListbirini veya diğerini görüntülersiniz, ancak ikisini birden görüntülemezsiniz. Windows, ortak bir dosya iletişim kutusu aracılığıyla açılırsa veya bir uygulamayı dosya türü ilişkilendirmesi aracılığıyla açmak için kullanılırsa, son öğeleri otomatik olarak yönetir. Bir öğeye Atlama Listesi aracılığıyla erişildiğinde, Windows kabuğuna yöntemini çağırarak öğeyi AddToRecentCategory kategorisine eklemesini bildirebilirsiniz.

Windows Kabuğuna Atlama Listesi Uygulama

Kabuğun Atlama Listesine doğrudan erişemez veya içeriğini sınıfına JumpList okuyamazsınız. Bunun yerine, JumpList sınıfı, birlikte çalışabileceğiniz ve ardından Windows kabuğuna uygulayabileceğiniz bir Atlama Listesi gösterimi sağlar. Genellikle bir JumpList oluşturur ve uygulama ilk kez çalıştırıldığında bunu bir kez ayarlarsınız. Ancak, çalışma zamanında değerini JumpList değiştirebilir veya değiştirebilirsiniz.

JumpList özelliklerini ayarladığınızda, JumpList içeriğinin görev çubuğu Atlama Listesi'nde görünmeden önce Windows kabuğuna uygulamanız gerekir. Bu, XAML'de veya yöntemine yapılan bir çağrıda JumpList bir uygulamaya ilk kez eklendiğinde SetJumpList otomatik olarak yapılır. çalışma zamanında JumpList içeriğini değiştirirseniz, geçerli içeriğini Windows kabuğuna uygulamak için Apply yöntemini çağırmanız gerekir.

XAML'de Atlama Listesi Ayarlama

bir JumpList nesneye Application otomatik olarak eklenmez. Ekli özellik söz dizimini kullanarak XAML'deki bir JumpList nesneye bir eklersinizApplication. sınıfı, JumpList XAML bildirimini desteklemek için arabirimini ISupportInitializeuygularJumpList. JumpList XAML'de bildirilir ve geçerli Application eklenirse, JumpList başlatıldığında Windows kabuğuna otomatik olarak uygulanır.

Kodda Atlama Listesi Ayarlama ve Değiştirme

Statik JumpList yöntemi çağırarak koddaki bir Application nesneye bir SetJumpList eklersiniz. Bu, Windows kabuğuna JumpList de uygulanır.

Bir çalışma zamanında değiştirmek JumpList için, şu anda bir GetJumpListöğesine bağlı olan öğesini almak JumpList için yöntemini çağırırsınızApplication. JumpList özelliklerini değiştirdikten sonra, değişiklikleri Windows kabuğuna uygulamak için Apply yöntemini çağırmanız gerekir.

Note

Genellikle JumpList ekli ve Windows kabuğuna uygulanan bir Application oluşturursunuz. Ancak, birden çok JumpList nesne oluşturabilirsiniz. Windows kabuğuna bir kerede yalnızca bir JumpList uygulanabilir ve aynı anda yalnızca bir JumpListApplication ilişkilendirilebilir. .NET Framework, bunların aynı JumpList olmasını gerektirmez.

Note

Bu sınıf, tüm üyeler için geçerli olan sınıf düzeyinde bir bağlantı talebi içerir. Hemen SecurityException çağıranın tam güven izni olmadığında bir oluşturulur. Güvenlik talepleri hakkında daha fazla bilgi için bkz. Bağlantı Talepleri ve Devralma Talepleri.

Oluşturucular

Name	Description
JumpList()	JumpList sınıfının yeni bir örneğini başlatır.
JumpList(IEnumerable<JumpItem>, Boolean, Boolean)	Belirtilen parametrelerle sınıfının yeni bir örneğini JumpList başlatır.

Özellikler

Name	Description
JumpItems	Atlama Listesinde görüntülenen nesne koleksiyonunu JumpItem alır.
ShowFrequentCategory	Sık kullanılan öğelerin Atlama Listesinde görüntülenip görüntülenmeyeceğini gösteren bir değer alır veya ayarlar.
ShowRecentCategory	Son kullanılan öğelerin Atlama Listesinde görüntülenip görüntülenmeyeceğini gösteren bir değer alır veya ayarlar.

Yöntemler

Name	Description
AddToRecentCategory(JumpPath)	Belirtilen atlama yolunu Atlama Listesi'nin En Son kategorisine ekler.
AddToRecentCategory(JumpTask)	Belirtilen atlama görevini Atlama Listesi'nin En Son kategorisine ekler.
AddToRecentCategory(String)	Belirtilen öğe yolunu Atlama Listesi'nin En Son kategorisine ekler.
Apply()	JumpList geçerli durumundaki Windows kabuğuna gönderir.
BeginInit()	Başlatmanın başlangıcına JumpList işaret eder.
EndInit()	Başlatmanın sonuna işaret JumpList eder.
GetJumpList(Application)	JumpList Bir uygulamayla ilişkili nesneyi döndürür.
SetJumpList(Application, JumpList)	JumpList Bir uygulamayla ilişkili nesneyi ayarlar.

Ekinlikler

Name	Description
JumpItemsRejected	Atlama öğeleri Windows kabuğu tarafından Atlama Listesi'ne başarıyla eklenmediği zaman gerçekleşir.
JumpItemsRemovedByUser	Daha önce Atlama Listesi'ndeki atlama öğeleri kullanıcı tarafından listeden kaldırıldığında gerçekleşir.