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 öğe 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'nin 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 kabukta 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 JumpItemsRemovedByUser olaylarını JumpItemsRejected 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 nasıl değişiklik yapılacağını, temizlenip oluşturulacağını JumpList gösterir. Yeni Atlama Listesi için statik SetJumpList yöntemi çağrılarak öğesini geçerli uygulamayla ilişkilendirir JumpList ve Windows kabuğuna JumpList uygular.

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 Listeleri'ni kullanarak programları doğrudan görev çubuğu düğmesinden 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 Görev Çubuğu bölümüne bakın.

sınıfı, JumpList 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. Sınıfı tarafından JumpList sunulan işlevsellik, Windows 7'den önceki Windows sürümlerinde kullanılamaz. sınıfını JumpList kullanan uygulamalar Windows'un diğer 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 . Görev Çubuğu Uzantıları.

Aşağıdaki çizimde, Görevler ve Sık Kullanılanlar kategorilerindeki öğelerle birlikte Windows Media Player için Atlama Listesi gösterilmektedir.

Windows Media Player Atlama Listesi

Atlama Listesi Yapılandırma

Atlama Listeleri, bir ve JumpPatholmak üzere JumpTask 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 belirtilmemiş TitleCustomCategory bir JumpTask oluşturarak Atlama Listesindeki öğeleri görsel olarak ayırabilirsiniz. Bu boş JumpTask , Atlama Listesi'nde yatay çizgi olarak görüntülenir.

Not

içinde JumpPath belirtilen dosyanın türü uygulamanızla kaydedilmediyse, 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, Görevler kategorisinde bir JumpItem görüntülenir. Alternatif olarak, için JumpItembir CustomCategory belirtebilirsiniz.

ve ShowFrequentCategory özelliklerini ayarlayarak içinde standart Son ve Sık Kullanılan kategorilerinin görüntülenip görüntülenmeyeceğini JumpListShowRecentCategory 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 her ikisini birden görüntülemezsiniz. Windows, ortak bir dosya iletişim kutusu aracılığıyla açılırlarsa veya bir uygulamayı dosya türü ilişkilendirmesi aracılığıyla açmak için kullanılırlarsa son öğeleri otomatik olarak yönetir. Atlama Listesi aracılığıyla bir öğeye erişildiğinde, windows kabuğuna yöntemini çağırarak öğeyi Son kategorisine eklemesini AddToRecentCategory 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 sınıfı, JumpList 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.

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

XAML'de Atlama Listesi Ayarlama

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

Kodda Atlama Listesi Ayarlama ve Değiştirme

Statik SetJumpList yöntemini çağırarak koddaki bir Application nesneye eklersinizJumpList. Bu, windows kabuğu için de geçerlidir JumpList .

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

Not

Genellikle öğesine eklenmiş ve Windows kabuğuna Application uygulanmış bir tane oluşturursunuzJumpList. Ancak, birden çok JumpList nesne oluşturabilirsiniz. JumpList Windows kabuğuna bir kerede yalnızca bir tane uygulanabilir ve bir ile aynı anda yalnızca bir Applicationtane JumpList ilişkilendirilebilir. .NET Framework, bunların aynı JumpListolmasını gerektirmez.

Not

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

Oluşturucular

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

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

Yöntemler

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()	geçerli JumpList durumunda windows kabuğuna gönderir.
BeginInit()	Başlatmanın başlangıcını JumpList bildirir.
EndInit()	Başlatmanın sona ereceğini JumpList bildirir.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetJumpList(Application)	JumpList Bir uygulamayla ilişkili nesneyi döndürür.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
SetJumpList(Application, JumpList)	JumpList Bir uygulamayla ilişkili nesneyi ayarlar.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ekinlikler

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.