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
省略可能です。環境内でアイテムが選択されているときに、ユーザーが Del キーを押して新しいタスク アイテムを削除できるかどうかを示します。既定値は true です。
- FlushItem
型 : System.Boolean
省略可能です。新しいアイテムが [タスク一覧] にすぐに表示されるかどうかを示します。 FlushItem を true に設定すると、Add が呼び出された直後に [タスク一覧] が更新されます。 FlushItem を false に設定すると、すべての更新が行われた後に [タスク一覧] が更新されます。 false の設定は、主に、一度に多くのアイテムを [タスク一覧] に追加する場合のパフォーマンスを向上するために使用されます。既定値は true です。
戻り値
型 : EnvDTE.TaskItem
TaskItem オブジェクト。
解説
ビットマップを追加する場合、RGB カラー 0x0000FF00 (緑) は透明になっています。この値を使用する画像の全領域が透明になるため、[タスク一覧] は透過的に表示されます。
ビットマップの幅と高さは、16 × 16 ピクセルに設定する必要があります。
IPictureDisp を使用する場合は、PICTYPE 引数を Icon または Bitmap のいずれかに設定する必要があります。Metafiles、Uninitialized、または None を設定すると、正しく動作しません。
例
この例では、2 つのタスク項目をタスク一覧に追加し、いくつかのプロパティをメッセージ ボックスに表示します。このアドインの例を実行する方法の詳細については、「方法 : オートメーション オブジェクト モデルのコード例をコンパイルおよび実行する」を参照してください。
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 セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。