Freigeben über


_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

Siehe auch

Referenz

_DTE Schnittstelle

EnvDTE-Namespace

Weitere Ressourcen

Erstellen von Add-Ins und Assistenten