TaskItems.Add Yöntem
Yeni bir görev öğesi ekler TaskList.
Ad alanı: EnvDTE
Derleme: EnvDTE (EnvDTE.dll içinde)
Sözdizimi
'Bildirim
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
Parametreler
- Category
Tür: System.String
Gerekli.Görev Madde kategori adını temsil eder.
- SubCategory
Tür: System.String
Gerekli.Görev öðesinin alt kategori adını temsil eder.
- Description
Tür: System.String
Gerekli.Görev öğesini tanımlar.
- Priority
Tür: EnvDTE.vsTaskPriority
İsteğe Bağlı.A vsTaskPriority (yüksek, Orta veya düşük) görev öðesi önceliğini gösteren sabit.Değer ise vsTaskPriorityHigh, bir ünlem işareti simgesi görev listesinin ilk sütununda görüntülenir.Değer ise vsTaskPriorityMedium, hiçbir şey görüntülenmez.Değer ise vsTaskPriorityLow, bir aşağı ok simgesi görüntülenir.
- Icon
Tür: System.Object
İsteğe Bağlı.Yeni görev öğesini temsil eden simge türünü belirler.Ayarı olmalıdır vsTaskIcon veya bir IPictureDisp.
- Checkable
Tür: System.Boolean
İsteğe Bağlı.Kullanıcılar görev tamamlandığında, göstermek için kontrol edebilirsiniz bir checkbox sağlamak üzere görev öðesi isteyip istemediğinizi belirtir. false varsayılan değerdir.
- File
Tür: System.String
İsteğe Bağlı.Dosya ya da yeni görev maddeyle ilişkili yolu gösterir.Varsayılan değer boş bir dizedir (""), ve kullanılırsa, IsSettable(vsTaskListColumnFile) döndüren false.Dosya adı, bir tam yol adı, bir göreceli yol adı veya yalnızca bir dosya adı olabilir.Bir dosya ya da yol bir madde ile ilişkilendirmek herhangi bir eylem gerçekleştirmek gelmez olduğunu unutmayın.
- Line
Tür: System.Int32
İsteğe Bağlı.Satırda yeni görev maddeyle ilişkili kaynak kodunu gösterir.Varsayılan değer 0'dır ve kullanılırsa, IsSettable(vsTaskListColumnLine) döndüren false.Satır numarasını bir madde ile ilişkilendirmek herhangi bir eylem gerçekleştirmek gelmez olduğunu unutmayın.
- CanUserDelete
Tür: System.Boolean
İsteğe Bağlı.Ortamda öğesi seçildiğinde delete tuşuna basarak kullanıcı yeni görev öðesini silip silemeyeceğini gösterir. true varsayılan değerdir.
- FlushItem
Tür: System.Boolean
İsteğe Bağlı.Yeni bir madde hemen görünür olup olmadığını gösterir Task List.Zaman FlushItem ayarlamak True, görev listesi Ekle çağrıldıktan hemen sonra güncelleştirilir.Zaman FlushItem ayarlamak false, tüm güncelleştirmeleri yapıldıktan sonra görev listesi daha sonra güncelleştirilir.A false ayarı aynı anda çok sayıda madde görev listesine eklemekte olduğunuz zaman öncelikle performansı geliştirmek için kullanılır. true varsayılan değerdir.
Dönüş Değeri
Tür: EnvDTE.TaskItem
TaskItem nesnesi
Notlar
rgb renk 0x0000FF00 (yeşil), bit eşlemler eklerken saydamdır.Bu değeri tüm yerlerde Resminizde saydam ve Task List aradan görünecektir.
Genişlik ve Yükseklik bitmaplerin 16 x 16 piksel olmalıdır.
Kullanarak, IPictureDisp, PICTYPE bağımsız değişkeni ayarlanmış olmalıdır olarak Icon veya Bitmap.Ayarları ya da Metafiles, Uninitialized, veya None düzgün çalışmaz.
Örnekler
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 Güvenliği
- Anında arayanlar için tam güven. Bu üye kısmen güvenilen kodla kullanılamaz. Daha fazla bilgi için bkz. Kısmen güvenilen kod kitaplıklarını kullanma.