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 对象或控件。
返回值
一个 Window 对象。
备注
如果在新工具窗口可见之前尝试设置该工具窗口的任何可见状态(如高度、宽度或位置),则会发生错误。因此,在试图设置任何此类属性之前,请确保窗口是可见的。
有关如何使用此方法的示例,请参见 Visual Studio Automation Samples(Visual Studio 自动化示例)网页上的 ToolWindow 示例。有关创建 ActiveX 控件的信息,请参见创建 MFC ActiveX 控件。
权限
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。