Compartir a través de


TaskItems2.Add2 (Método)

Agrega un nuevo elemento de tarea a TaskList.

Espacio de nombres:  EnvDTE80
Ensamblado:  EnvDTE80 (en EnvDTE80.dll)

Sintaxis

'Declaración
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: System.String
    Obligatorio.Representa el nombre de categoría del elemento de tarea.
  • SubCategory
    Tipo: System.String
    Obligatorio.Representa el nombre de la subcategoría del elemento de tarea.
  • Description
    Tipo: System.String
    Obligatorio.Describe el elemento de tarea.
  • Icon
    Tipo: System.Object
    Opcional.Determina el tipo de icono que representa el nuevo elemento de tarea.La configuración debe ser vsTaskIcon o IPictureDisp.
  • Checkable
    Tipo: System.Boolean
    Opcional.Indica si se desea que el elemento de tarea proporcione una casilla que los usuarios puedan activar para indicar que se ha completado la tarea.El valor predeterminado es false.
  • File
    Tipo: System.String
    Opcional.Indica el archivo o la ruta de acceso asociados al nuevo elemento de tarea.El valor predeterminado es una cadena vacía ("") y, si se utiliza, IsSettable(vsTaskListColumnFile) devuelve false.El nombre de archivo puede ser una ruta de acceso completa, una ruta de acceso relativa o simplemente un nombre de archivo.Tenga en cuenta que, si se asocia un archivo o una ruta de acceso a un elemento, no implica necesariamente que vaya a realizar ninguna acción.
  • Line
    Tipo: System.Int32
    Opcional.Indica la línea del código fuente asociada al nuevo elemento de tarea.El valor predeterminado es 0 y, si se utiliza, IsSettable(vsTaskListColumnLine) devuelve false.Tenga en cuenta que, si se asocia un número de línea a un elemento, no implica necesariamente que vaya a realizar ninguna acción.
  • CanUserDelete
    Tipo: System.Boolean
    Opcional.Indica si un usuario puede eliminar el nuevo elemento de tarea presionando SUPRIMIR cuando el elemento se selecciona en el entorno.El valor predeterminado es true.
  • FlushItem
    Tipo: System.Boolean
    Opcional.Indica si un elemento nuevo aparece inmediatamente en la Lista de tareas.Cuando FlushItem se establece en true, la Lista de tareas se actualiza inmediatamente después de llamar a Add.Cuando FlushItem se establece en false, la Lista de tareas se actualiza después de que se hayan efectuado todas las actualizaciones.La opción false se utiliza principalmente para mejorar el rendimiento cuando se agrega una gran cantidad de elementos a la vez a la Lista de tareas.El valor predeterminado es true.
  • AutoNavigate
    Tipo: System.Boolean
    Opcional.Indica si TaskItem tiene habilitada la característica AutoNavigate.AutoNavigate está habilitada cuando se establece en true; de lo contrario, es false.

Valor devuelto

Tipo: EnvDTE.TaskItem
Un objeto TaskItem.

Comentarios

Cuando se agregan mapas de bits, el color RGB 0x0000FF00 (verde) es transparente. Todas las partes de la imagen en las que se utiliza este valor son transparentes y la Lista de tareas se muestra de igual manera.

El ancho y el alto de los mapas de bits debe ser de 16 x 16 píxeles.

Si se utiliza IPictureDisp, el argumento PICTYPE se debe establecer en Icon o Bitmap. Las configuraciones Metafiles, Uninitialized o None no funcionan correctamente.

Ejemplos

Este ejemplo agrega dos elementos de tarea a la lista de tareas mediante el método Add2 y muestra algunas de sus propiedades en cuadros de mensaje. Para obtener más información sobre cómo ejecutar este ejemplo como un complemento, vea Cómo: Compilar y ejecutar los ejemplos de código del modelo de objetos de automatización.

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);
}

Seguridad de .NET Framework

Vea también

Referencia

TaskItems2 Interfaz

EnvDTE80 (Espacio de nombres)