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 상수입니다.이 값이 vsTaskPriorityHigh이면 작업 목록의 첫 번째 열에 느낌표 아이콘이 표시됩니다.값이 vsTaskPriorityMedium이면 아무것도 표시되지 않습니다.값이 vsTaskPriorityLow이면 아래쪽 화살표 아이콘이 표시됩니다.
- 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
선택적 요소로서,환경에서 새 작업 항목이 선택된 경우 사용자가 Delete 키를 눌러 이 항목을 삭제할 수 있는지 여부를 나타냅니다.기본값은 true입니다.
- FlushItem
형식: System.Boolean
선택적 요소로서,새 항목이 작업 목록에 바로 표시되는지 여부를 나타냅니다.FlushItem을 True로 설정하면 작업 목록은 Add가 호출된 후 바로 업데이트되고FlushItem을 false로 설정하면 작업 목록은 업데이트가 모두 완료된 후 나중에 업데이트됩니다.false 설정은 주로 한 번에 작업 목록에 추가하는 항목 수가 많은 경우 성능을 향상시키기 위해 사용됩니다.기본값은 true입니다.
반환 값
형식: EnvDTE.TaskItem
TaskItem 개체입니다.
설명
비트맵을 추가할 때 RGB 색 0x0000FF00(녹색)은 투명합니다. 또한 그림에서 이 값을 사용하는 모든 부분이 투명하므로 작업 목록이 비치게 됩니다.
비트맵의 너비와 높이는 16 x 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 보안
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.