_DTE.UserControl - свойство
Обновлен: Ноябрь 2007
Возвращает или задает значение, которое указывает, была ли среда запущена пользователем или автоматизацией.
Пространство имен: EnvDTE
Сборка: EnvDTE (в EnvDTE.dll)
Синтаксис
'Декларация
Property UserControl As Boolean
'Применение
Dim instance As _DTE
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.
Заметки
Свойству 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
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.