Método TaskItems2.Add2
Adiciona um novo item de tarefa para o TaskList.
Namespace: EnvDTE80
Assembly: EnvDTE80 (em EnvDTE80.dll)
Sintaxe
'Declaração
Function Add2 ( _
Category As String, _
SubCategory As String, _
Description As String, _
Priority As Integer, _
Icon As Object, _
Checkable As Boolean, _
File As String, _
Line As Integer, _
CanUserDelete As Boolean, _
FlushItem As Boolean, _
AutoNavigate As Boolean _
) As TaskItem
TaskItem Add2(
string Category,
string SubCategory,
string Description,
int Priority,
Object Icon,
bool Checkable,
string File,
int Line,
bool CanUserDelete,
bool FlushItem,
bool AutoNavigate
)
TaskItem^ Add2(
[InAttribute] String^ Category,
[InAttribute] String^ SubCategory,
[InAttribute] String^ Description,
[InAttribute] int Priority,
[InAttribute] Object^ Icon,
[InAttribute] bool Checkable,
[InAttribute] String^ File,
[InAttribute] int Line,
[InAttribute] bool CanUserDelete,
[InAttribute] bool FlushItem,
[InAttribute] bool AutoNavigate
)
abstract Add2 :
Category:string *
SubCategory:string *
Description:string *
Priority:int *
Icon:Object *
Checkable:bool *
File:string *
Line:int *
CanUserDelete:bool *
FlushItem:bool *
AutoNavigate:bool -> TaskItem
function Add2(
Category : String,
SubCategory : String,
Description : String,
Priority : int,
Icon : Object,
Checkable : boolean,
File : String,
Line : int,
CanUserDelete : boolean,
FlushItem : boolean,
AutoNavigate : boolean
) : TaskItem
Parâmetros
Category
Tipo: StringObrigatório. Representa o nome da categoria do item de tarefa.
SubCategory
Tipo: StringObrigatório. Representa o nome da subcategoria do item de tarefa.
Description
Tipo: StringObrigatório. Descreve o item de tarefa.
Priority
Tipo: Int32Opcional. A 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 é exibido. Se o valor for vsTaskPriorityLow, uma seta para baixo o ícone é exibido.
Icon
Tipo: ObjectOpcional. Determina o tipo de ícone que representa o novo item de tarefa. A configuração deve ser vsTaskIcon ou um IPictureDisp.
Checkable
Tipo: BooleanOpcional. Indica se ou não pretende que o item de tarefa para fornecer uma caixa de seleção que os usuários podem verificar para indicar que a tarefa foi concluída. O valor padrão é false.
File
Tipo: StringOpcional. Indica o arquivo ou caminho associados com o novo item de tarefa. O valor padrão é uma seqüência vazia (""), e se isso for usado, IsSettable(vsTaskListColumnFile) retorna 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 com um item não significa necessariamente que ele executa todas as ações.
Line
Tipo: Int32Opcional. Indica a linha no código fonte associada com o novo item de tarefa. O valor padrão é 0, e se isso for usado, IsSettable(vsTaskListColumnLine) retorna false. Observe que a associar a um item de um número de linha não significa necessariamente que ele executa todas as ações.
CanUserDelete
Tipo: BooleanOpcional. 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
Tipo: BooleanOpcional. Indica se um novo item é imediatamente visível no Lista de tarefas. Quando FlushItem for definido como true, o Lista de tarefas é atualizado imediatamente após a Add é chamado. Quando FlushItem for definido como false, o Lista de tarefas é atualizado mais tarde, depois de todas as atualizações são feitas. A false configuração é usada principalmente para melhorar o desempenho quando você está adicionando um grande número de itens por vez para o Lista de tarefas. O valor padrão é true.
AutoNavigate
Tipo: BooleanOpcional. Indica se a TaskItem tem a função de AutoNavigate ativada. AutoNavigate está no quando isso é definido como true; Caso contrário, false.
Valor de retorno
Tipo: TaskItem
A TaskItem object.
Comentários
Ao adicionar bitmaps, a cor RGB 0x0000FF00 (verde) é transparente. Todos os lugares na sua figura que usam esse valor são transparentes e o Lista de tarefas transparece.
A largura e altura de bitmaps devem ser 16 x 16 pixels.
Se usando IPictureDisp, o argumento PICTYPE deve ser definido de qualquer Icon ou Bitmap. Configurações de Metafiles, Uninitialized, ou None não funcionam corretamente.
Exemplos
Este exemplo adiciona dois itens à lista de tarefas de tarefas usando o Add2 método e exibe algumas de suas propriedades nas caixas de mensagem. Para obter mais informações sobre como executar este exemplo como um add-in, consulte Como compilar e executar os exemplos de código do modelo de objeto Automation.
Imports EnvDTE
Imports EnvDTE80
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)
TaskItemsAdd2Example(_applicationObject)
End Sub
Sub TaskItemsAdd2Example(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 using Add2.
TLItem = TLItems.Add2(" ", " ", "Test task 1." _
, vsTaskPriority.vsTaskPriorityHigh, vsTaskIcon.vsTaskIconUser _
, True, , 10, , , False)
TLItem = TLItems.Add2(" ", " ", "Test task 2." _
, vsTaskPriority.vsTaskPriorityLow, vsTaskIcon.vsTaskIconComment _
, , , 20, , , False)
' 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 OnConnection(object application,
ext_ConnectMode connectMode, object addInInst, ref Array custom)
{
_applicationObject = (DTE2)application;
_addInInstance = (AddIn)addInInst;
TaskItems2Add2Example(_applicationObject);
}
public void TaskItems2Add2Example(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.Add2("MyTask", "MyTask1", "Test task 1."
, 1, vsTaskIcon.vsTaskIconUser, true,null,10,true,true,true);
TLItem = TLItems.Add2("MyTask", "MyTask1", "Test task 2."
, 2, vsTaskIcon.vsTaskIconComment, true, null, 20, true, true,false);
// 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);
}
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.