Proprietà _DTE.UserControl

Articolo
08/11/2011

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

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.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.

Note

UserControl può essere impostato su true, per indicare l'interazione di un utente con l'ambiente. Una volta eseguita questa operazione, tuttavia, non è possibile riportare l'impostazione su false tramite 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 di Windows è creato dall'utente e UserControl viene impostato 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 impostato su true in modo irreversibile, non sarà 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?: " & DTE.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.