_DTE.UserControl 属性

设置或获取一个值,该值指示环境是由用户启动还是自动启动的。

命名空间:  EnvDTE
程序集:  EnvDTE(在 EnvDTE.dll 中)

语法

声明
Property UserControl As Boolean
bool UserControl { get; set; }
property bool UserControl {
    bool get ();
    void set (bool value);
}
abstract UserControl : bool with get, set
function get UserControl () : boolean
function set UserControl (value : boolean)

属性值

类型:System.Boolean
如果环境在用户控制下运行,则为 true;否则为 false。

备注

UserControl 可以设为 true,这表示人将与环境进行交互,但此设置完成后,外接程序或宏无法将其重新更改为 false。

如果环境不受用户控制,并且最后的外部自动化客户端断开连接,则环境将关闭。

如果通过**“开始”**菜单启动环境,则环境是用户创建的,并且 UserControl 设置为 true。但是,如果由 CoCreate 启动环境,则环境是自动创建的,并且 UserControl 设置为 false。

仅当 UserControl 设置为 false 时,才可以通过自动化控制主窗口的可见性。一旦它不可逆转地设为 true,便无法再隐藏主窗口。

手动尝试打开新的解决方案或文档将导致 UserControl 设置为 true。自动尝试这样做则不会影响该值。

示例

Sub UserControlExample()
   MsgBox("Environment is running under user control?: " & DTE.UserControl)
End Sub

.NET Framework 安全性

请参见

参考

_DTE 接口

EnvDTE 命名空间

其他资源

创建外接程序和向导