Propriedade DTE2.UserControl

Artigo
08/01/2011

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

Valor de propriedade

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

Implementações

_DTE.UserControl

Comentários

UserControlpode ser definido como true, indicando que um ser humano está interagindo com o ambiente. Feito isso, um suplemento ou macro não pode alterá-lo novamente para false.

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

Se você iniciar o ambiente por meio de Iniciar menu, é criado pelo usuário e UserControl for definido como true. Se o ambiente é iniciado por CoCreate, no entanto, é criado para 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

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.