Windows.CreateToolWindow メソッド

更新 : 2007 年 11 月

指定した Document オブジェクトまたは ActiveX コントロールを含む新しいツール ウィンドウを作成します。

名前空間 :  EnvDTE
アセンブリ :  EnvDTE (EnvDTE.dll 内)

構文

'宣言
Function CreateToolWindow ( _
    AddInInst As AddIn, _
    ProgID As String, _
    Caption As String, _
    GuidPosition As String, _
    <OutAttribute> ByRef DocObj As Object _
) As Window
'使用
Dim instance As Windows
Dim AddInInst As AddIn
Dim ProgID As String
Dim Caption As String
Dim GuidPosition As String
Dim DocObj As Object
Dim returnValue As Window

returnValue = instance.CreateToolWindow(AddInInst, _
    ProgID, Caption, GuidPosition, DocObj)
Window CreateToolWindow(
    AddIn AddInInst,
    string ProgID,
    string Caption,
    string GuidPosition,
    out Object DocObj
)
Window^ CreateToolWindow(
    [InAttribute] AddIn^ AddInInst, 
    [InAttribute] String^ ProgID, 
    [InAttribute] String^ Caption, 
    [InAttribute] String^ GuidPosition, 
    [InAttribute] [OutAttribute] Object^% DocObj
)
function CreateToolWindow(
    AddInInst : AddIn, 
    ProgID : String, 
    Caption : String, 
    GuidPosition : String, 
    DocObj : Object
) : Window

パラメータ

  • AddInInst
    型 : EnvDTE.AddIn

    必ず指定します。AddIn オブジェクトを指定します。このオブジェクトの有効期間によって、ツール ウィンドウの有効期間が決まります。

  • ProgID
    型 : System.String

    必ず指定します。Document オブジェクトまたは ActiveX コントロールのプログラム ID を指定します。

  • Caption
    型 : System.String

    必ず指定します。新しいツール ウィンドウのキャプション。

  • GuidPosition
    型 : System.String

    必ず指定します。新しいツール ウィンドウの一意の識別子を指定します。この識別子は、Item へのインデックスとして使用できます。

  • DocObj
    型 : System.Object%

    必ず指定します。ツール ウィンドウ内でホストされる Document オブジェクトまたはコントロールを指定します。

戻り値

型 : EnvDTE.Window

Window オブジェクト。

解説

ツール ウィンドウを表示する前に、新しいツール ウィンドウの表示状態 (高さ、幅、位置など) を設定しようとすると、エラーが発生します。したがって、このようなプロパティの設定を行う前に、ウィンドウが表示されていることを確認してください。

このメソッドの使用例については、Visual Studio の Web ページ「Automation Samples」にある ToolWindow のサンプルを参照してください。ActiveX コントロールの作成方法の詳細については、「MFC ActiveX コントロールの作成」を参照してください。

アクセス許可

  • 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

参照

Windows インターフェイス

Windows メンバ

EnvDTE 名前空間