JumpTask Classe

Definizione

Spazio dei nomi:

System.Windows.Shell

Assembly:

PresentationFramework.dll

Rappresenta un collegamento a un'applicazione nella jump list della barra delle applicazioni di Windows 7.

public ref class JumpTask : System::Windows::Shell::JumpItem

public class JumpTask : System.Windows.Shell.JumpItem

type JumpTask = class
    inherit JumpItem

Public Class JumpTask
Inherits JumpItem

Ereditarietà

Object

JumpItem

JumpTask

Esempio

Nell'esempio seguente viene illustrato come dichiarare un oggetto JumpTask nel markup. Apre JumpTask un file di testo denominato readme.txt nell'applicazione Blocco note.

<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"/>

Nell'esempio seguente viene illustrato come configurare un oggetto JumpTask nel codice. Apre JumpTask l'applicazione Calcolatrice.

// 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";

Commenti

Un JumpTask può essere considerato come un collegamento a un'applicazione. Specificare il percorso del file eseguibile impostando la ApplicationPath proprietà . Se l'oggetto ApplicationPath non è impostato, il percorso del processo in esecuzione corrente è implicito. Facoltativamente, è possibile specificare Arguments di passare all'applicazione all'avvio.

È possibile impostare le proprietà di visualizzazione di base, ad esempio Title, Descriptione IconResourcePath per specificare l'aspetto dell'attività nella Jump List. Un'icona usata con deve JumpTask essere disponibile come risorsa nativa. Se in una DLL o in un file eseguibile sono disponibili più risorse icona, specificarne una da usare indicando un offset nella IconResourceIndex proprietà .

Per impostazione predefinita, un JumpTask oggetto verrà inserito nella categoria Attività della Jump List. È possibile specificare il raggruppamento personalizzato delle attività impostando la CustomCategory proprietà .

È possibile separare visivamente gli elementi in un jump list creando un oggetto JumpTask che non dispone di un Title oggetto e CustomCategory specificato. Questo vuoto JumpTask verrà visualizzato come linea orizzontale nella Jump List. In questo caso, è possibile impostare altre proprietà, ma non avranno alcun effetto.

Costruttori

Nome	Descrizione
JumpTask()	Inizializza una nuova istanza della classe JumpTask.

Proprietà

Nome	Descrizione
ApplicationPath	Ottiene o imposta il percorso dell'applicazione.
Arguments	Ottiene o imposta gli argomenti passati all'applicazione all'avvio.
CustomCategory	Ottiene o imposta il nome della categoria JumpItem con cui è raggruppato nella jump list della barra delle applicazioni di Windows 7. (Ereditato da JumpItem)
Description	Ottiene o imposta il testo visualizzato nella descrizione comando per l'attività nella Jump List.
IconResourceIndex	Ottiene o imposta l'indice in base zero di un'icona incorporata in una risorsa.
IconResourcePath	Ottiene o imposta il percorso di una risorsa che contiene l'icona da visualizzare nella Jump List.
Title	Ottiene o imposta il testo visualizzato per l'attività nella Jump List.
WorkingDirectory	Ottiene o imposta la directory di lavoro dell'applicazione all'avvio.

Vedi anche

• JumpPath
• JumpList
• JumpItemsRejected
• Startup
• Args