Proprietà DTE2.UserControl

Articolo
08/11/2011

Ottiene un valore che indica se l'ambiente è stato avviato da un utente o mediante automazione.

Spazio dei nomi: EnvDTE80
Assembly: EnvDTE80 (in EnvDTE80.dll)

Sintassi

'Dichiarazione
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)

Valore proprietà

Tipo: System.Boolean
true se l'ambiente è in esecuzione sotto il controllo dell'utente; in caso contrario false.

Implementa

_DTE.UserControl

Note

È possibile impostare la proprietà UserControl su true per indicare che un utente sta interagendo con l'ambiente. Una volta effettuata l'impostazione, non è più possibile impostarla nuovamente su false mediante un componente aggiuntivo o una macro.

Se l'ambiente non è sotto il controllo di un utente e viene disconnesso l'ultimo client esterno di automazione, l'esecuzione dell'ambiente verrà terminata.

Un ambiente avviato utilizzando il menu Start è creato dall'utente e la proprietà UserControl è impostata su true. Un ambiente avviato mediante CoCreate è invece creato tramite automazione e la proprietà UserControl è impostata su false.

È possibile controllare la visibilità della finestra principale mediante automazione solo quando la proprietà UserControl è impostata su false. Una volta impostata su true in modo irreversibile non sarà più possibile nascondere la finestra principale.

Se si cerca di aprire in modo manuale una nuova soluzione o un nuovo documento, la proprietà UserControl verrà impostata su true. Se si cerca di eseguire la stessa operazione in modo automatico, il valore non verrà modificato.

Esempi

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.