TaskItems2.Add 메서드 (String, String, String, vsTaskPriority, Object, Boolean, String, Int32, Boolean, Boolean)
TaskList에 새 작업 항목을 추가합니다.
네임스페이스: EnvDTE80
어셈블리: EnvDTE80(EnvDTE80.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으로 설정하면 올바르게 작동하지 않습니다.
예제
이 예제에서는 작업 항목 두 개를 작업 목록에 추가하고 해당 속성의 일부를 메시지 상자에 표시합니다. 이 예제를 추가 기능으로 실행하는 방법에 대한 자세한 내용은 방법: 자동화 개체 모델 코드의 예제 컴파일 및 실행을 참조하십시오.
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)
TaskItems2Example(_applicationObject)
End Sub
Sub TaskItems2Example(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.
TLItem = TLItems.Add(" ", " ", "Test task 1.", _
vsTaskPriority.vsTaskPriorityHigh, vsTaskIcon.vsTaskIconUser _
, True, , 10, , )
TLItem = TLItems.Add(" ", " ", "Test task 2." _
, vsTaskPriority.vsTaskPriorityLow, vsTaskIcon.vsTaskIconComment _
, , , 20, , )
' 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;
TaskItems2Example(_applicationObject);
}
public void TaskItems2Example(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.Add("MyTask", "MyTask1", "Test task 1."
, vsTaskPriority.vsTaskPriorityHigh, vsTaskIcon.vsTaskIconUser
, true,null,10,true,true );
TLItem = TLItems.Add("MyTask", "MyTask1", "Test task 2."
, vsTaskPriority.vsTaskPriorityLow, vsTaskIcon.vsTaskIconComment
, true, null, 20, true, true);
// 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);
}
.NET Framework 보안
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.