JumpList Sınıf

Tanım

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")]
[System.Security.SecurityCritical]
public sealed class JumpList : System.ComponentModel.ISupportInitialize

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

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

Public NotInheritable Class JumpList
Implements ISupportInitialize

Devralma

Object

JumpList

Öznitelikler

ContentPropertyAttribute SecurityCriticalAttribute

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.

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.

Oluşturucular

Özellikler

Yöntemler

Ekinlikler

Şunlara uygulanır