DTE2.UserControl-Eigenschaft

Artikel
08/10/2011

Ruft einen Wert ab, der angibt, ob die Umgebung von einem Benutzer oder der Automatisierung gestartet wurde.

Namespace: EnvDTE80
Assembly: EnvDTE80 (in EnvDTE80.dll)

Syntax

'Declaration
Property UserControl As Boolean
    Get
    Set

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: System.Boolean
true, wenn die Umgebung benutzergesteuert ausgeführt wird; andernfalls false.

Implementiert

_DTE.UserControl

Hinweise

UserControl kann auf true festgelegt werden, um anzugeben, dass ein Mensch mit der Umgebung interagiert. Nachdem dies erfolgt ist, kann ein Add-In oder ein Makro diesen Wert nicht wieder in false ändern.

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. Sobald der Wert true unabänderlich 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?: " & DTE2.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.