OutputWindowPane.OutputTaskItemString (Método)

Muestra una cadena en la ventana de salida y agrega un elemento correspondiente a la Lista de tareas.

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

Sintaxis

'Declaración
Sub OutputTaskItemString ( _
    Text As String, _
    Priority As vsTaskPriority, _
    SubCategory As String, _
    Icon As vsTaskIcon, _
    FileName As String, _
    Line As Integer, _
    Description As String, _
    Force As Boolean _
)

void OutputTaskItemString(
    string Text,
    vsTaskPriority Priority,
    string SubCategory,
    vsTaskIcon Icon,
    string FileName,
    int Line,
    string Description,
    bool Force
)

void OutputTaskItemString(
    [InAttribute] String^ Text, 
    [InAttribute] vsTaskPriority Priority, 
    [InAttribute] String^ SubCategory, 
    [InAttribute] vsTaskIcon Icon, 
    [InAttribute] String^ FileName, 
    [InAttribute] int Line, 
    [InAttribute] String^ Description, 
    [InAttribute] bool Force
)

abstract OutputTaskItemString : 
        Text:string * 
        Priority:vsTaskPriority * 
        SubCategory:string * 
        Icon:vsTaskIcon * 
        FileName:string * 
        Line:int * 
        Description:string * 
        Force:bool -> unit

function OutputTaskItemString(
    Text : String, 
    Priority : vsTaskPriority, 
    SubCategory : String, 
    Icon : vsTaskIcon, 
    FileName : String, 
    Line : int, 
    Description : String, 
    Force : boolean
)

Parámetros

• Text
  Tipo: String

  Obligatorio. Texto que se va a agregar a la ventana de salida.

• Priority
  Tipo: EnvDTE.vsTaskPriority

  Obligatorio. Constante vsTaskPriority que representa la prioridad del nuevo elemento de tarea.

• SubCategory
  Tipo: String

  Obligatorio. Subcategoría que se va a utilizar para el nuevo elemento de tarea.

• Icon
  Tipo: EnvDTE.vsTaskIcon

  Obligatorio. Constante vsTaskIcon que representa el icono que se va a utilizar para el nuevo elemento de tarea.

• FileName
  Tipo: String

  Obligatorio. Nombre de archivo que se va a asociar al nuevo elemento de tarea. Puede ser una cadena vacía.

• Line
  Tipo: Int32

  Obligatorio. Línea de código con la que se relaciona el nuevo elemento de tarea.

• Description
  Tipo: String

  Obligatorio. Descripción del nuevo elemento de tarea.

• Force
  Tipo: Boolean

  Opcional. Indica si la ventana de salida debe actualizar inmediatamente la Lista de tareas. El valor predeterminado es True. Si va a agregar varios elementos, establezca Force en False y, a continuación, establezca Force en True en el último elemento.

Comentarios

Para que los números de línea aparezcan en la Lista de tareas, es necesario especificar la ruta de acceso completa en el parámetro FileName. (Por ejemplo, c:\workfile.txt). El archivo debe existir en esa ubicación. La razón es que la ventana de salida se asegura de que el archivo especificado existe antes de mostrar los números de línea.

Ejemplos

Sub OutputTaskItemStringExample()
   ' Create a tool window handle for the Output window.
   Dim win As Window = DTE.Windows.Item(EnvDTE.Constants.vsWindowKindOutput)
   ' Create handles to the Output window and its panes.
   Dim OW As OutputWindow = win.Object
   Dim OWp As OutputWindowPane

   ' Add a new pane to the Output window.
   OWp = OW.OutputWindowPanes.Add("A New Pane")
   ' Add a line of text to the new pane and to the Task List.
   OWp.OutputTaskItemString("Some task", vsTaskPriority.vsTaskPriorityHigh, vsTaskCategories.vsTaskCategoryMisc, vsTaskIcon.vsTaskIconComment, "C:\temp", 100, "Some description")
   ' You can also use the 'True' flag on the end of OutputTaskItemString 
   ' rather than using the next line (ForceItemsToTaskList).
   OWp.ForceItemsToTaskList()
End Sub

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

OutputWindowPane Interfaz

EnvDTE (Espacio de nombres)