Application Classe

Définition

Fournit des propriétés et des méthodes static pour gérer une application, comme des méthodes permettant de démarrer et d'arrêter une application et de traiter des messages Windows, et des propriétés permettant d'obtenir des informations sur une application. Cette classe ne peut pas être héritée.

public ref class Application sealed
public sealed class Application
type Application = class
Public NotInheritable Class Application
Héritage
Application

Exemples

L’exemple de code suivant répertorie les nombres dans une zone de liste d’un formulaire. Chaque fois que vous cliquez sur button1, l’application ajoute un autre nombre à la liste.

La Main méthode appelle Run pour démarrer l’application, qui crée le formulaire, listBox1 et button1. Lorsque l’utilisateur clique sur button1, la button1_Click méthode affiche un MessageBox. Si l’utilisateur clique No sur , MessageBoxla button1_Click méthode ajoute un nombre à la liste. Si l’utilisateur clique sur Yes, l’application appelle Exit pour traiter tous les messages restants dans la file d’attente, puis pour quitter.

Notes

L’appel à Exit échouera en confiance partielle.

public ref class Form1: public System::Windows::Forms::Form
{
private:
   Button^ button1;
   ListBox^ listBox1;

public:
   Form1()
   {
      button1 = gcnew Button;
      button1->Left = 200;
      button1->Text =  "Exit";
      button1->Click += gcnew EventHandler( this, &Form1::button1_Click );
      listBox1 = gcnew ListBox;
      this->Controls->Add( button1 );
      this->Controls->Add( listBox1 );
   }

private:
   void Form1::button1_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      int count = 1;
      
      // Check to see whether the user wants to exit 
      // the application. If not, add a number to the list box.
      while ( MessageBox::Show(  "Exit application?",  "", MessageBoxButtons::YesNo ) == ::DialogResult::No )
      {
         listBox1->Items->Add( count );
         count += 1;
      }

      
      // The user wants to exit the application. 
      // Close everything down.
      Application::Exit();
   }

};

int main()
{
   
   // Starts the application.
   Application::Run( gcnew Form1 );
}
public class Form1 : Form
{
    [STAThread]
    public static void Main()
    {
        // Start the application.
        Application.Run(new Form1());
    }

    private Button button1;
    private ListBox listBox1;

    public Form1()
    {
        button1 = new Button();
        button1.Left = 200;
        button1.Text = "Exit";
        button1.Click += new EventHandler(button1_Click);

        listBox1 = new ListBox();
        this.Controls.Add(button1);
        this.Controls.Add(listBox1);
    }

    private void button1_Click(object sender, System.EventArgs e)
    {
        int count = 1;
        // Check to see whether the user wants to exit the application.
        // If not, add a number to the list box.
        while (MessageBox.Show("Exit application?", "",
            MessageBoxButtons.YesNo)==DialogResult.No)
        {
            listBox1.Items.Add(count);
            count += 1;
        }

        // The user wants to exit the application.
        // Close everything down.
        Application.Exit();
    }
}
Public Class Form1 
    Inherits Form

    <STAThread()> _
     Shared Sub Main()
        ' Start the application.
        Application.Run(New Form1)
    End Sub

    Private WithEvents button1 As Button
    Private WithEvents listBox1 As ListBox

    Public Sub New()
        button1 = New Button
        button1.Left = 200
        button1.Text = "Exit"

        listBox1 = New ListBox
        Me.Controls.Add(button1)
        Me.Controls.Add(listBox1)
    End Sub

    Private Sub button1_Click(ByVal sender As Object, _
        ByVal e As System.EventArgs) Handles button1.Click
        Dim count As Integer = 1
        ' Check to see whether the user wants to exit the application.
        ' If not, add a number to the list box.
        While (MessageBox.Show("Exit application?", "", _
            MessageBoxButtons.YesNo) = DialogResult.No)

            listBox1.Items.Add(count)
            count += 1

        End While

        ' The user wants to exit the application. 
        ' Close everything down.
        Application.Exit()
    End Sub

End Class

Remarques

La Application classe a des méthodes pour démarrer et arrêter des applications et des threads, et pour traiter les messages Windows, comme suit :

  • Run démarre une boucle de message d’application sur le thread actif et, éventuellement, rend un formulaire visible.

  • Exit ou ExitThread arrête une boucle de message.

  • DoEvents traite les messages pendant que votre programme est dans une boucle.

  • AddMessageFilter ajoute un filtre de message à la pompe de messages d’application pour surveiller les messages Windows.

  • IMessageFilter vous permet d’arrêter la levée d’un événement ou d’effectuer des opérations spéciales avant d’appeler un gestionnaire d’événements.

Cette classe a CurrentCulture des propriétés et CurrentInputLanguage pour obtenir ou définir des informations de culture pour le thread actif.

Vous ne pouvez pas créer de instance de cette classe.

Propriétés

AllowQuit

Obtient une valeur indiquant si l'appelant peut quitter cette application.

ColorMode

Fournit des propriétés et des méthodes static pour gérer une application, comme des méthodes permettant de démarrer et d'arrêter une application et de traiter des messages Windows, et des propriétés permettant d'obtenir des informations sur une application. Cette classe ne peut pas être héritée.

CommonAppDataPath

Obtient le chemin des données d’application partagé par tous les utilisateurs.

CommonAppDataRegistry

Obtient la clé de Registre des données d'application partagées entre tous les utilisateurs.

CompanyName

Obtient le nom de la société associée à l'application.

CurrentCulture

Obtient ou définit les informations sur la culture du thread en cours.

CurrentInputLanguage

Obtient ou définit le langage d'entrée actuel du thread en cours.

ExecutablePath

Obtient le chemin d’accès au fichier exécutable ayant démarré l’application, y compris le nom de l’exécutable.

HighDpiMode

Obtient le mode haute résolution actuel de l’application.

IsDarkModeEnabled

Fournit des propriétés et des méthodes static pour gérer une application, comme des méthodes permettant de démarrer et d'arrêter une application et de traiter des messages Windows, et des propriétés permettant d'obtenir des informations sur une application. Cette classe ne peut pas être héritée.

LocalUserAppDataPath

Obtient le chemin d’accès aux données d’application d’un utilisateur local non itinérant.

MessageLoop

Obtient une valeur indiquant si une boucle de messages existe sur ce thread.

OpenForms

Obtient une collection de formulaires ouverts possédée par l’application.

ProductName

Obtient le nom du produit associé à cette application.

ProductVersion

Obtient la version du produit associé à cette application.

RenderWithVisualStyles

Obtient une valeur qui spécifie si l'application actuelle dessine des contrôles avec des styles visuels.

SafeTopLevelCaptionFormat

Obtient ou définit la chaîne de format à appliquer aux titres des fenêtres de niveau supérieur lorsqu'ils s'affichent avec une bannière d'avertissement.

StartupPath

Obtient le chemin d’accès au fichier exécutable ayant démarré l’application, sans le nom de l’exécutable.

SystemColorMode

Fournit des propriétés et des méthodes static pour gérer une application, comme des méthodes permettant de démarrer et d'arrêter une application et de traiter des messages Windows, et des propriétés permettant d'obtenir des informations sur une application. Cette classe ne peut pas être héritée.

UserAppDataPath

Obtient le chemin d’accès aux données d’application d’un utilisateur.

UserAppDataRegistry

Obtient la clé de Registre pour les données d'application d'un utilisateur.

UseVisualStyles

Obtient une valeur qui indique si les styles visuels sont activés pour l’application.

UseWaitCursor

Obtient ou définit si le curseur d'attente est utilisé pour tous les formulaires ouverts de l'application.

VisualStyleState

Obtient une valeur qui spécifie l'application de styles visuels aux fenêtres d'application.

Méthodes

AddMessageFilter(IMessageFilter)

Ajoute un filtre de messages permettant de surveiller les messages Windows lors de leur routage vers leur destination.

DoEvents()

Traite tous les messages Windows présents dans la file d'attente de messages.

EnableVisualStyles()

Active les styles visuels pour l'application.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
Exit()

Informe toutes les pompes de messages qu'elles doivent se terminer, puis ferme toutes les fenêtres d'application une fois les messages traités.

Exit(CancelEventArgs)

Informe toutes les pompes de messages qu'elles doivent se terminer, puis ferme toutes les fenêtres d'application une fois les messages traités.

ExitThread()

Quitte la boucle de messages du thread en cours et ferme toutes les fenêtres du thread.

FilterMessage(Message)

Applique tous les filtres à un message de fenêtre et retourne une copie du message modifié.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
OleRequired()

Initialise OLE sur le thread en cours.

OnThreadException(Exception)

Déclenche l’événement ThreadException.

RaiseIdle(EventArgs)

Déclenche l'événement Idle dans les scénarios hébergés.

RegisterMessageLoop(Application+MessageLoopCallback)

Enregistre un rappel pour vérifier si la boucle de message s'exécute dans des environnements hébergés.

RemoveMessageFilter(IMessageFilter)

Enlève un filtre de messages de la pompe de messages de l'application.

Restart()

Ferme l'application et lance immédiatement une nouvelle instance.

Run()

Commence à exécuter une boucle de messages d'application standard sur le thread en cours, sans formulaire.

Run(ApplicationContext)

Commence à exécuter une boucle de messages d'application standard sur le thread en cours, avec ApplicationContext.

Run(Form)

Commence à exécuter une boucle de messages d'application standard sur le thread en cours et affiche le formulaire spécifié.

SetColorMode(SystemColorMode)

Fournit des propriétés et des méthodes static pour gérer une application, comme des méthodes permettant de démarrer et d'arrêter une application et de traiter des messages Windows, et des propriétés permettant d'obtenir des informations sur une application. Cette classe ne peut pas être héritée.

SetCompatibleTextRenderingDefault(Boolean)

Définit la valeur par défaut à l’échelle de l’application pour la UseCompatibleTextRendering propriété définie sur certains contrôles.

SetDefaultFont(Font)

Définit la valeur par défaut Font pour le processus.

SetHighDpiMode(HighDpiMode)

Définit le mode haute résolution du processus.

SetSuspendState(PowerState, Boolean, Boolean)

Suspend ou met en veille prolongée le système, ou demande que le système soit suspendu ou mis en veille prolongée.

SetUnhandledExceptionMode(UnhandledExceptionMode)

Indique à l'application comment répondre aux exceptions non gérées.

SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean)

Indique à l'application comment répondre aux exceptions non gérées, en appliquant éventuellement un comportement spécifique au thread.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
UnregisterMessageLoop()

Annule l'enregistrement du rappel de boucle de message réalisé avec RegisterMessageLoop(Application+MessageLoopCallback).

Événements

ApplicationExit

Se produit lorsque l'application est sur le point de s'arrêter.

EnterThreadModal

Se produit lorsque l'application est sur le point d'activer l'état modal.

Idle

Se produit lorsque l'application termine le traitement et est sur le point de passer à l'état inactif.

LeaveThreadModal

Se produit lorsque l'application est sur le point de quitter l'état modal.

ThreadException

Se produit lorsqu'une exception de thread ininterrompu est levée.

ThreadExit

Se produit lorsqu'un thread est sur le point de s'arrêter. Lorsque le principal thread d'une application est sur le point de s'arrêter, cet événement commence par se déclencher, suivi d'un événement ApplicationExit.

S’applique à