Procedura: controllare l'elenco attività

Aggiornamento: novembre 2007

L'elenco attività e il relativo contenuto possono essere controllati mediante automazione. Esso viene rappresentato nel modello di automazione di Visual Studio dagli oggetti e dagli insiemi riportati di seguito:

Nome oggetto	Descrizione
Oggetto TaskList	Rappresenta l’elenco attività.
Insieme TaskItems	Rappresenta tutte le attività visualizzate nell’elenco attività.
Oggetto TaskItem	Rappresenta una singola attività visualizzata nell'elenco attività.
Oggetto TaskListEvents	Consente di rispondere agli eventi che si verificano nell'elenco attività.

Questi oggetti e insiemi consentono di:

• Creare un elemento attività e aggiungerlo all'elenco attività tramite il metodo Add) o eliminarlo dall'elenco attività tramite il metodo Delete.

• Ottenere gli elementi attualmente presenti nell'elenco attività tramite il metodo Select.

• Visualizzare un documento associato a un elemento attività tramite il metodo Navigate.

• Selezionare un elemento attività tramite il metodo Select.

• Rispondere quando un elemento attività viene aggiunto, rimosso, modificato o selezionato tramite gli eventi TaskAdded, TaskRemoved, TaskModified e TaskNavigated.

Oltre a controllare il contenuto dell'elenco attività, è possibile controllarne caratteristiche quali larghezza e altezza. Per ulteriori informazioni, vedere Procedura: modificare le caratteristiche delle finestre.

Nota:

Le finestre di dialogo e i comandi di menu visualizzati potrebbero non corrispondere a quelli descritti nella Guida in linea in quanto dipendono dall'edizione o dalle impostazioni attive. Queste routine sono state sviluppate con le Impostazioni generali per lo sviluppo attive. Per modificare le impostazioni, scegliere Importa/EsportaImpostazioni dal menu Strumenti. Per ulteriori informazioni, vedere Impostazioni di Visual Studio.

Esempio

Nell'esempio di componente aggiuntivo riportato di seguito viene illustrato come fare riferimento ai diversi membri del modello di automazione dell'elenco attività e come utilizzarli. In questo esempio vengono aggiunte nuove attività all'elenco attività, viene elencato il numero delle attività e ne viene eliminata una. Prima di eseguire l'esempio riportato di seguito, scegliere Elenco attività dal menu Visualizza.

Public Sub OnConnection(ByVal application As Object, ByVal _
  connectMode As ext_ConnectMode, ByVal addInInst As Object, _
  ByRef custom As Array) Implements IDTExtensibility2.OnConnection
    _applicationObject = CType(application, DTE2)
    _addInInstance = CType(addInInst, AddIn)
    ' Pass the applicationObject member variable to the code example.
    TaskListExample(_applicationObject)
End Sub

Sub TaskListExample(ByVal dte As DTE2)
    Dim tl As TaskList = dte.ToolWindows.TaskList
    Dim tlItem As TaskItem

    ' Add a couple of tasks to the Task List.
    tlItem = tl.TaskItems.Add(" ", " ", "Test task 1.", _
      vsTaskPriority.vsTaskPriorityHigh, vsTaskIcon.vsTaskIconUser, _
      True, , 10, , )
    tlItem = tl.TaskItems.Add(" ", " ", "Test task 2.", _
      vsTaskPriority.vsTaskPriorityLow, vsTaskIcon.vsTaskIconComment, _
      , , 20, , )

    ' List the total number of task list items after adding the new 
    ' task items.
    MsgBox("Task Item 1 description: " & _
      tl.TaskItems.Item(2).Description)
    MsgBox("Total number of task items: " & tl.TaskItems.Count)

    ' Remove the second task item. The items list in reverse numeric 
    ' order.
    MsgBox("Deleting the second task item")
    tl.TaskItems.Item(2).Delete()
    MsgBox("Total number of task items: " & tl.TaskItems.Count)
End Sub

using System.Windows.Forms;
public void OnConnection(object application, ext_ConnectMode   
connectMode, object addInInst, ref Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    // Pass the applicationObject member variable to the code example.
    TaskListExample(_applicationObject);
}

public void TaskListExample(DTE2 dte)
{
    TaskList tl = (TaskList)dte.ToolWindows.TaskList;
    TaskItem tlItem;
    
    // Add a couple of tasks to the Task List.
    tlItem = tl.TaskItems.Add(" ", " ", "Test task 1.",  
      vsTaskPriority.vsTaskPriorityHigh, vsTaskIcon.vsTaskIconUser, 
      true, "", 10, true, true);
    tlItem = tl.TaskItems.Add(" ", " ", "Test task 2.", 
      vsTaskPriority.vsTaskPriorityLow, vsTaskIcon.vsTaskIconComment, 
      true, "", 20, true,true);

    // List the total number of task list items after adding the new 
    // task items.
    System.Windows.Forms.MessageBox.Show("Task Item 1 description: 
      "+tl.TaskItems.Item(2).Description);
    System.Windows.Forms.MessageBox.Show("Total number of task items: 
      "+tl.TaskItems.Count);

    // Remove the second task item. The items list in reverse numeric 
    // order.
    System.Windows.Forms.MessageBox.Show("Deleting the second task 
      item");
    tl.TaskItems.Item(2).Delete();
    System.Windows.Forms.MessageBox.Show("Total number of task items: 
      "+tl.TaskItems.Count);
}

Vedere anche

Attività

Procedura: modificare le caratteristiche delle finestre

Procedura: creare un componente aggiuntivo

Procedura dettagliata: creazione di una procedura guidata

Concetti

Grafico del modello oggetto di automazione

Riferimenti

Elenco attività (Visual Studio)

Altre risorse

Creazione e controllo delle finestre di ambiente

Creazione di componenti aggiuntivi e di procedure guidate

Riferimenti su extensibility e automazione