DTE2.UserControl - свойство

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает значение, которое указывает, была ли среда запущена пользователем или автоматически.

Пространство имен: EnvDTE80
Сборка: EnvDTE80 (в EnvDTE80.dll)

Синтаксис

'Декларация
Property UserControl As Boolean
'Применение
Dim instance As DTE2
Dim value As Boolean

value = instance.UserControl

instance.UserControl = value

bool UserControl { get; set; }

property bool UserControl {
    bool get ();
    void set (bool value);
}

function get UserControl () : boolean
function set UserControl (value : boolean)

Значение свойства

Тип: System.Boolean
Значение true, если среда работает под управлением пользователя, в противном случае — false.

Реализации

_DTE.UserControl

Заметки

Для UserControl можно задать значение true, указывающее, что со средой взаимодействует человек. В этом случае надстройка или макрос не сможет изменить это значение обратно на значение false.

Если среда работает не под управлением пользователя, то при отключении последнего внешнего клиента автоматизации среда завершает работу.

Если пользователь запустил среду из меню Пуск, она считается запущенной пользователем и свойство UserControl имеет значение true. Если среда запущена CoCreate, она считается созданной автоматически и свойство UserControl имеет значение false.

Видимостью основного окна при автоматизации можно управлять, только если свойство UserControl имеет значение false. Если оно имеет значение true, которое нельзя изменить, основное окно нельзя скрыть.

Попытка вручную открыть новое решение или документ приведет к установке для UserControl значения true. Попытка сделать это автоматически не повлияет на значение свойства.

Примеры

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

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.