TaskItems2.Add(String, String, String, vsTaskPriority, Object, Boolean, String, Int32, Boolean, Boolean) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Adiciona um novo item de tarefa ao TaskList .
EnvDTE::TaskItem Add(std::wstring const & Category, std::wstring const & SubCategory, std::wstring const & Description, EnvDTE::vsTaskPriority Priority = EnvDTE.vsTaskPriority.vsTaskPriorityMedium, winrt::Windows::Foundation::IInspectable const & Icon, bool Checkable = false, std::wstring const & File = "", int Line = -1, bool CanUserDelete = true, bool FlushItem = true);
[System.Runtime.InteropServices.DispId(4)]
public EnvDTE.TaskItem Add (string Category, string SubCategory, string Description, EnvDTE.vsTaskPriority Priority = EnvDTE.vsTaskPriority.vsTaskPriorityMedium, object Icon, bool Checkable = false, string File = "", int Line = -1, bool CanUserDelete = true, bool FlushItem = true);
[<System.Runtime.InteropServices.DispId(4)>]
abstract member Add : string * string * string * EnvDTE.vsTaskPriority * obj * bool * string * int * bool * bool -> EnvDTE.TaskItem
Public Function Add (Category As String, SubCategory As String, Description As String, Optional Priority As vsTaskPriority = EnvDTE.vsTaskPriority.vsTaskPriorityMedium, Optional Icon As Object, Optional Checkable As Boolean = false, Optional File As String = "", Optional Line As Integer = -1, Optional CanUserDelete As Boolean = true, Optional FlushItem As Boolean = true) As TaskItem
Parâmetros
- Category
- String
Obrigatórios. Representa o nome da categoria do item de tarefa.
- SubCategory
- String
Obrigatórios. Representa o nome da subcategoria do item de tarefa.
- Description
- String
Obrigatórios. Descreve o item de tarefa.
- Priority
- vsTaskPriority
Opcional. Uma vsTaskPriority constante que indica a prioridade do item de tarefa: alta, média ou baixa. Se o valor for vsTaskPriorityHigh , um ícone de ponto de exclamação será exibido na primeira coluna da lista de tarefas. Se o valor for vsTaskPriorityMedium , nada será exibido. Se o valor for vsTaskPriorityLow , será exibido um ícone de seta para baixo.
- Icon
- Object
Opcional. Determina o tipo de ícone que representa o novo item de tarefa. A configuração deve ser vsTaskIcon um ou um IPictureDisp .
- Checkable
- Boolean
Opcional. Indica se você deseja ou não que o item de tarefa forneça uma caixa de seleção que os usuários possam verificar para indicar que a tarefa foi concluída. O valor padrão é false.
- File
- String
Opcional. Indica o arquivo ou caminho associado ao novo item de tarefa. O valor padrão é uma cadeia de caracteres vazia ("") e, se for usado, IsSettable[vsTaskListColumn] ( vsTaskListColumnFile ) retornará false . O nome do arquivo pode ser um caminho completo, um caminho relativo ou simplesmente um nome de arquivo. Observe que a associação de um arquivo ou caminho a um item não significa necessariamente que ele executa qualquer ação.
- Line
- Int32
Opcional. Indica a linha no código-fonte associado ao novo item de tarefa. O valor padrão é 0 e, se for usado, IsSettable[vsTaskListColumn] ( vsTaskListColumnLine ) retornará false . Observe que a associação de um número de linha a um item não significa necessariamente que ele executa qualquer ação.
- CanUserDelete
- Boolean
Opcional. Indica se um usuário pode excluir o novo item de tarefa pressionando DELETE quando o item é selecionado no ambiente. O valor padrão é true.
- FlushItem
- Boolean
Opcional. Indica se um novo item está visível imediatamente no lista de tarefas. Quando FlushItem é definido como true , o lista de tarefas é atualizado imediatamente após Add ser chamado. Quando FlushItem é definido como false , o lista de tarefas é atualizado posteriormente depois que todas as atualizações são feitas. Uma false configuração é usada principalmente para melhorar o desempenho quando você está adicionando vários itens por vez ao lista de tarefas. O valor padrão é true.
Retornos
Um objeto TaskItem.
Implementações
- Atributos
Exemplos
Imports EnvDTE
Imports EnvDTE80
Sub TaskItems2Example(ByVal dte As DTE2)
Dim win As Window = _applicationObject.Windows.Item _
(Constants.vsWindowKindTaskList)
Dim TL As TaskList = CType(win.Object, TaskList)
Dim TLItem As TaskItem
Dim TLItems As TaskItems2
TLItems = CType(TL.TaskItems, TaskItems2)
' Add a couple of tasks to the Task List.
TLItem = TLItems.Add(" ", " ", "Test task 1.", _
vsTaskPriority.vsTaskPriorityHigh, vsTaskIcon.vsTaskIconUser _
, True, , 10, , )
TLItem = TLItems.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: " & TLItems.Item(2).Description)
MsgBox("Total number of task items: " & TLItems.Count)
' Remove the second task item.
' The items list in reverse numeric order.
MsgBox("Deleting the second task item")
TLItems.Item(1).Delete()
MsgBox("Total number of task items: " & TLItems.Count)
End Sub
using EnvDTE;
using EnvDTE80;
using System.Windows.Forms;
public void TaskItems2Example(DTE2 dte)
{
Window2 win = (Window2)_applicationObject.Windows.Item
(Constants.vsWindowKindTaskList);
TaskList TL = (TaskList)win.Object;
TaskItem TLItem;
TaskItems2 TLItems;
TLItems = (TaskItems2)TL.TaskItems;
// Add a couple of tasks to the Task List.
TLItem = TLItems.Add("MyTask", "MyTask1", "Test task 1."
, vsTaskPriority.vsTaskPriorityHigh, vsTaskIcon.vsTaskIconUser
, true,null,10,true,true );
TLItem = TLItems.Add("MyTask", "MyTask1", "Test task 2."
, vsTaskPriority.vsTaskPriorityLow, vsTaskIcon.vsTaskIconComment
, true, null, 20, true, true);
// List the total number of task list items after adding the new
// task items.
MessageBox.Show("Task Item 1 description: " +
TLItems.Item(2).Description);
MessageBox.Show("Total number of task items: "
+ TLItems.Count.ToString());
// Remove the second task item.
// The items list in reverse numeric order.
MessageBox.Show("Deleting the second task item");
TLItems.Item(1).Delete();
MessageBox.Show("Total number of task items: " + TLItems.Count);
}
Comentários
Ao adicionar bitmaps, a cor RGB 0x0000FF00 (verde) é transparente. Todos os locais em sua imagem que usam esse valor são transparentes e o lista de tarefas mostra.
A largura e a altura dos bitmaps devem ter 16 x 16 pixels.
Se estiver usando IPictureDisp , o argumento PICTYPE deverá ser definido como Icon ou Bitmap . As configurações de Metafiles , Uninitialized ou None não funcionam corretamente.