_DTE.UserControl, propriété
Définit ou obtient une valeur indiquant si l'environnement a été lancé par un utilisateur ou par Automation.
Espace de noms : EnvDTE
Assembly : EnvDTE (dans EnvDTE.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
Il est possible d'affecter à la propriété UserControl la valeur true, indiquant qu'un opérateur humain interagit avec l'environnement ; toutefois, une fois la valeur de la propriété définie, un complément ou une macro ne peuvent plus changer sa valeur 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 à cette propriété, il n'est plus possible de cacher la fenêtre principale.
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?: " & DTE.UserControl)
End Sub
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.