Compartilhar via


Propriedade DTE2.UserControl

Obtém um valor indicando se o ambiente foi iniciado por um usuário ou por automação.

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

Sintaxe

'Declaração
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)

Valor de propriedade

Tipo: Boolean
true Se o ambiente estiver executando sob o controle de usuário; Caso contrário, false.

Comentários

UserControlpode ser definida como true, indicando que um ser humano está interagindo com o ambiente. Quando isso é feito, um suplemento ou macro não é possível alterá-lo novamente para false.

Se o ambiente não está sob controle de usuário e o último cliente de automação externa se desconecta, o ambiente está desativado.

Se você iniciar o ambiente por meio de Iniciar menu, ele é criado pelo usuário e UserControl for definido como true. Se o ambiente é iniciado por CoCreate, no entanto, é criada a automação e UserControl for definido como false.

Você pode controlar a visibilidade da janela principal por meio da automação somente quando UserControl for definido como false. Depois de configurado irreversibly true, a janela principal não pode ser ocultada.

Manualmente a tentativa de abrir um documento ou uma nova solução faz com que UserControl a ser definida para true. Automaticamente tentar fazer o mesmo não afeta o valor.

Exemplos

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

Segurança do .NET Framework

Consulte também

Referência

DTE2 Interface

Namespace EnvDTE80

Outros recursos

Criando suplementos e assistentes