Metodo TaskItems.Add
Aggiunge una nuova attività all'oggetto TaskList.
Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)
Sintassi
'Dichiarazione
Function Add ( _
Category As String, _
SubCategory As String, _
Description As String, _
Priority As vsTaskPriority, _
Icon As Object, _
Checkable As Boolean, _
File As String, _
Line As Integer, _
CanUserDelete As Boolean, _
FlushItem As Boolean _
) As TaskItem
TaskItem Add(
string Category,
string SubCategory,
string Description,
vsTaskPriority Priority,
Object Icon,
bool Checkable,
string File,
int Line,
bool CanUserDelete,
bool FlushItem
)
TaskItem^ Add(
[InAttribute] String^ Category,
[InAttribute] String^ SubCategory,
[InAttribute] String^ Description,
[InAttribute] vsTaskPriority Priority,
[InAttribute] Object^ Icon,
[InAttribute] bool Checkable,
[InAttribute] String^ File,
[InAttribute] int Line,
[InAttribute] bool CanUserDelete,
[InAttribute] bool FlushItem
)
abstract Add :
Category:string *
SubCategory:string *
Description:string *
Priority:vsTaskPriority *
Icon:Object *
Checkable:bool *
File:string *
Line:int *
CanUserDelete:bool *
FlushItem:bool -> TaskItem
function Add(
Category : String,
SubCategory : String,
Description : String,
Priority : vsTaskPriority,
Icon : Object,
Checkable : boolean,
File : String,
Line : int,
CanUserDelete : boolean,
FlushItem : boolean
) : TaskItem
Parametri
- Category
Tipo: System.String
Obbligatoria.Rappresenta il nome della categoria dell'elemento attività.
- SubCategory
Tipo: System.String
Obbligatorio.Rappresenta il nome della sottocategoria dell'elemento attività.
- Description
Tipo: System.String
Obbligatorio.Fornisce una descrizione dell'attività.
- Priority
Tipo: EnvDTE.vsTaskPriority
Facoltativo.Costante vsTaskPriority che denota la priorità dell'attività (alta, media o bassa).Se il valore è vsTaskPriorityHigh, nella prima colonna dell'Elenco attività verrà visualizzata l'icona di un punto esclamativo.Se il valore è vsTaskPriorityMedium, non viene visualizzato nulla.Se il valore è vsTaskPriorityLow, viene visualizzata l'icona di una freccia verso il basso.
- Icon
Tipo: System.Object
Facoltativo.Determina il tipo di icona che rappresenta la nuova attività.L'impostazione deve essere vsTaskIcon o IPictureDisp.
- Checkable
Tipo: System.Boolean
Facoltativo.Indica se si desidera che venga fornita una casella di controllo che gli utenti possono selezionare per indicare che l'attività è completata.Il valore predefinito è false.
- File
Tipo: System.String
Facoltativo.Indica il file o il percorso associato alla nuova attività.Il valore predefinito è una stringa vuota ("") e se viene utilizzato, IsSettable(vsTaskListColumnFile) restituisce false.Il nome file può essere il nome di un percorso completo, di un percorso relativo o semplicemente un nome di file.Si noti che l'associazione di un file o di un percorso a un elemento non significa necessariamente che verrà eseguita un'azione.
- Line
Tipo: System.Int32
Facoltativo.Indica la riga del codice sorgente associata alla nuova attività.Il valore predefinito è 0 e, se utilizzata, IsSettable(vsTaskListColumnLine) restituisce false.Si noti che l'associazione di un numero di riga a un elemento non significa necessariamente che verrà eseguita un'azione.
- CanUserDelete
Tipo: System.Boolean
Facoltativo.Indica se un utente può eliminare la nuova attività premendo CANC quando l'elemento è selezionato nell'ambiente.Il valore predefinito è true.
- FlushItem
Tipo: System.Boolean
Facoltativo.Indica se una nuova attività diventa immediatamente visibile nell'Elenco attività.Quando FlushItem è impostato su True, l'Elenco attività viene aggiornato immediatamente dopo la chiamata ad Add.Quando FlushItem è impostato su false, l'Elenco attività viene aggiornato successivamente al termine di tutti gli aggiornamenti.L'impostazione false viene utilizzata principalmente per migliorare le prestazioni quando viene aggiunto all'Elenco attività un grande numero di elementi contemporaneamente.Il valore predefinito è true.
Valore restituito
Tipo: EnvDTE.TaskItem
Un oggetto TaskItem.
Note
Quando vengono aggiunte immagini bitmap, il colore RGB 0x0000FF00 (verde) è trasparente. Le parti dell'immagine che sono di tale colore saranno trasparenti nell'Elenco attività.
La larghezza e l'altezza delle immagini bitmap devono essere pari a 16 x 16 pixel.
Se si utilizza IPictureDisp, è necessario impostare l'argomento PICTYPE su Icon o Bitmap. L'impostazione di Metafiles, Uninitialized o None non funzionerà correttamente.
Esempi
Sub TaskItemsAddExample1()
Dim win As Window = DTE.Windows.Item(Constants.vsWindowKindTaskList)
Dim TL As TaskList = win.Object
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, _
"c:\temp.txt", 10, , )
TLItem = TL.TaskItems.Add(" ", " ", "Test task 2.", _
vsTaskPriority.vsTaskPriorityLow, vsTaskIcon.vsTaskIconComment, _
False, "c:\temp2.txt", 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(1).Delete()
MsgBox("Total number of task items: " & TL.TaskItems.Count)
End Sub
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.