_DTE.UserControl-Eigenschaft
Legt einen Wert fest oder ruft einen Wert ab, der angibt, ob die Umgebung von einem Benutzer oder durch Automatisierung gestartet wurde.
Namespace: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)
Syntax
'Declaration
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)
Eigenschaftswert
Typ: Boolean
true, wenn die Umgebung benutzergesteuert ausgeführt wird; andernfalls false.
Hinweise
UserControl kann auf true festgelegt werden, um anzugeben, dass ein Benutzer mit der Umgebung in Interaktion tritt. Nachdem diese Einstellung vorgenommen wurde, kann die Eigenschaft jedoch nicht wieder von einem Add-In oder Makro auf false festgelegt werden.
Wenn die Umgebung nicht durch den Benutzer gesteuert wird und der letzte externe Automatisierungsclient die Verbindung trennt, wird die Umgebung heruntergefahren.
Wenn Sie die Umgebung über das Startmenü ausführen, wird diese vom Benutzer gesteuert, und UserControl wird auf true festgelegt. Wird die Umgebung dagegen über CoCreate gestartet, wird sie von der Automatisierung gesteuert, und UserControl wird auf false festgelegt.
Sie können die Sichtbarkeit des Hauptfensters nur dann über die Automatisierung steuern, wenn UserControl auf false festgelegt wurde. Nachdem der Wert true endgültig festgelegt wurde, kann das Hauptfenster nicht mehr ausgeblendet werden.
Beim manuellen Öffnen einer neuen Projektmappe oder eines Dokuments wird UserControl auf true festgelegt. Wenn dies jedoch automatisch versucht wird, ändert sich der Wert nicht.
Beispiele
Sub UserControlExample()
MsgBox("Environment is running under user control?: " & DTE.UserControl)
End Sub
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.