Partager via


DTE2.UserControl, propriété

Obtient une valeur indiquant si l'environnement a été démarré par un utilisateur ou par automation.

Espace de noms :  EnvDTE80
Assembly :  EnvDTE80 (dans EnvDTE80.dll)

Syntaxe

'Déclaration
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)

Valeur de propriété

Type : Boolean
true si l'exécution de l'environnement est contrôlée par l'utilisateur ; sinon, false.

Notes

UserControl peut avoir la valeur true, indiquant qu'une personne interagit avec l'environnement. Une fois que cela est fait, un Complément ou une macro ne peut plus le rechanger en false.

Si l'environnement n'est pas sous contrôle de l'utilisateur, et que le dernier client externe Automation est déconnecté, l'environnement s'arrête.

Si vous démarrez l'environnement par le biais du menu Démarrer, il est créé par l'utilisateur, et la propriété UserControl prend la valeur true. Si vous démarrez l'environnement par CoCreate, il est créé par automation, et la propriété UserControl prend la valeur false.

Vous pouvez contrôler la visibilité de la fenêtre principale par automation uniquement lorsque la propriété UserControl a la valeur false. Une fois que la valeur true a été attribuée définitivement à cette propriété, la fenêtre principale ne peut plus être masquée.

Toute tentative d'ouverture manuelle d'une nouvelle solution ou d'un nouveau document a pour effet de définir la propriété UserControl avec la valeur true. En revanche, la même tentative opérée automatiquement n'affecte pas la valeur de cette propriété.

Exemples

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

Sécurité .NET Framework

Voir aussi

Référence

DTE2 Interface

EnvDTE80, espace de noms

Autres ressources

Création de compléments et d'Assistants