TaskItems.Add أسلوب

قم بإضافة مهمة جديدة العنصر إلى TaskList.

مساحة الاسم:  EnvDTE
التجميع:  EnvDTE (في EnvDTE.dll)

بناء الجملة

'إقرار
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

المعلمات

• Category
  النوع: System.String
  مطلوبة.يمثل اسم فئة مهمة العنصر.

• SubCategory
  النوع: System.String
  مطلوبة.يمثل اسم فئة فرعية مهمة العنصر.

• Description
  النوع: System.String
  مطلوبة.وصف مهمة العنصر.

• Priority
  النوع: EnvDTE.vsTaskPriority
  اختياري.vsTaskPriorityثابت denoting أولوية مهمة العنصر (عالية أو متوسطة أو منخفضة).إذا $ $ $ $ قيمة هو vsTaskPriorityHigh، رمز تعجب هو dهوplayed في العمود أول من Lهوt المهمة.إذا $ $ $ $ قيمة هو vsTaskPriorityMedium، لا شيء هو dهوplayed.إذا $ $ $ $ قيمة هو vsTaskPriorityLow، استمرار رمز السهم هو dهوplayed.

• Icon
  النوع: System.Object
  اختياري.يحدد نوع الرمز الذي يمثل مهمة الجديدة العنصر.يجب أن يكون إعداد أي vsTaskIconأو IPictureDisp.

• Checkable
  النوع: System.Boolean
  اختياري.تشير إلى ما إذا كنت تريد عنصر مهمة لتوفير خانة اختيار التي يمكن للمستخدمين تدقيق للإشارة إلى مهمة هو كاملة.القيمة الافتراضية هي false.

• File
  النوع: System.String
  اختياري.تشير ملف أو مسار المقترن بعنصر مهمة جديد.القيمة افتراضية هو سلسلة فارغ ("")، وإذا كان ترتيب هو هو الاستخدام، ترجع IsSettable(vsTaskListColumnFile) false.يمكن أن يكون اسم الملف أو اسم مسار كامل اسم مسار نسبي أو اسم ملف فقط.لاحظ أن اقتران الملف أو مسار باستخدام العنصر لا يعني أن يقوم بتنفيذ أية الاجراءات الضرورة.

• Line
  النوع: System.Int32
  اختياري.الإشارة إلى السطر في تعليمات برمجية المصدر المقترنة بعنصر مهمة جديد.القيمة افتراضية هي 0، وإذا تم استخدامه، ترجع IsSettable(vsTaskListColumnLine) false.ملاحظة هذا رقم باستخدام خط اقتران العنصر لا يعني أن يقوم بتنفيذ أية الاجراءات الضرورة.

• CanUserDelete
  النوع: System.Boolean
  اختياري.الإشارة إلى ما إذا كان يمكن لمستخدم يحذف عنصر مهمة جديد بالضغط على ييحذف عند العنصر هو المحدد في بيئة.القيمة الافتراضية هي true.

• FlushItem
  النوع: System.Boolean
  اختياري.الإشارة إلى ما إذا كان عنصر جديد? هو vهوible مباشرة في من Lهوt المهمة.عند FlushItemهو تعيين إلى True، Lهوt المهام هو محدثها مباشرة بعد إضافة هو تسمى.عند FlushItemهو تعيين إلى false، Lهوt المهام هو محدثها لاحقاً بعد إجراء الجميع المحدثات.A false setting هو used primarily إلى enhance performance when you are adding a large number of items at a time إلى the مهمة قائمة. القيمة الافتراضية هي true.

القيمة المُرجعة

النوع: EnvDTE.TaskItem
كائن TaskItem .

ملاحظات

عند إضافة صور نقطية، RGB ألوان 0x0000FF00 (أخضر) هو شفافة. الجميع الأماكن في الصورة باستخدام هذه القيمة ستكون شفافة و ستظهر قائمة المهام من خلال.

العرض و يجب أن يكون الارتفاع للصور النقطية 16 × 16 بكسل.

في حالة استخدام IPictureDisp، PICTYPEيجب تعيين وسيطة إلى أما Iconأو Bitmap. الإعدادات لأي Metafiles، Uninitialized، أو Noneلا يعمل بشكل صحيح.

أمثلة

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

أمن NET Framework.

• الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.

راجع أيضًَا

المرجع

TaskItems واجهة

TaskItems الأعضاء

EnvDTE مساحة الاسم