Application Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

Application.cs

static metódusokat és tulajdonságokat biztosít az alkalmazások kezeléséhez, például az alkalmazások elindításához és leállításához, az Windows üzenetek feldolgozásához, valamint az alkalmazások adatainak lekéréséhez szükséges tulajdonságokat. Ez az osztály nem örökölhető.

public ref class Application sealed

public sealed class Application

type Application = class

Public NotInheritable Class Application

Öröklődés

Object

Application

Példák

Az alábbi példakód egy űrlap listamezőjében lévő számokat sorolja fel. Minden kattintáskor button1az alkalmazás hozzáad egy újabb számot a listához.

A Main metódus meghívja Run az alkalmazást, amely létrehozza az űrlapot, listBox1 és button1. Amikor a felhasználó rákattint button1, a button1_Click metódus megjelenít egy MessageBox. Ha a felhasználó a Nogombra kattintMessageBox, a button1_Click metódus hozzáad egy számot a listához. Ha a felhasználó rákattint Yes, az alkalmazás meghívja Exit az üzenetsor összes fennmaradó üzenetének feldolgozását, majd a kilépést.

Note

A hívás részleges megbízhatósági kapcsolaton fog meghiúsulni Exit .

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

Megjegyzések

A Application osztály az alkalmazások és szálak indítására és leállítására, valamint Windows üzenetek feldolgozására az alábbiak szerint rendelkezik:

• Run elindít egy alkalmazásüzenet-hurkot az aktuális szálon, és opcionálisan láthatóvá teszi az űrlapot.

• Exit vagy ExitThread leállítja az üzenethurkot.

• DoEvents üzeneteket dolgoz fel, miközben a program ciklusban van.

• AddMessageFilter hozzáad egy üzenetszűrőt az alkalmazás üzenetszivattyúhoz Windows üzenetek figyeléséhez.

• IMessageFilter lehetővé teszi, hogy megakadályozza az esemény létrehozását, vagy speciális műveleteket hajtson végre az eseménykezelő meghívása előtt.

Ez az osztály rendelkezik CurrentCulture az CurrentInputLanguage aktuális szál kulturális információinak lekéréséhez vagy beállításához szükséges tulajdonságokkal.

Az osztály egy példányát nem hozhatja létre.

Tulajdonságok

Name	Description
AllowQuit	Beolvas egy értéket, amely jelzi, hogy a hívó kiléphet-e az alkalmazásból.
ColorMode	Lekéri az alkalmazás alapértelmezett színmódját (sötét mód).
CommonAppDataPath	Lekéri az összes felhasználó által megosztott alkalmazásadatok elérési útját.
CommonAppDataRegistry	Lekéri az összes felhasználó által megosztott alkalmazásadatok beállításkulcsát.
CompanyName	Lekéri az alkalmazáshoz társított cégnevet.
CurrentCulture	Lekéri vagy beállítja az aktuális szál kulturális adatait.
CurrentInputLanguage	Lekéri vagy beállítja az aktuális szál aktuális beviteli nyelvét.
ExecutablePath	Lekéri az alkalmazást elindító végrehajtható fájl elérési útját, beleértve a végrehajtható nevet is.
HighDpiMode	Lekéri az alkalmazás jelenlegi magas DPI-módját.
IsDarkModeEnabled	Beolvas egy értéket, amely jelzi, hogy az alkalmazás sötét rendszerszín környezetben fut-e.
LocalUserAppDataPath	Lekéri egy helyi, nem központi felhasználó alkalmazásadatainak elérési útját.
MessageLoop	Beolvas egy értéket, amely jelzi, hogy van-e üzenethurok ezen a szálon.
OpenForms	Lekéri az alkalmazás tulajdonában lévő nyílt űrlapok gyűjteményét.
ProductName	Lekéri az alkalmazáshoz társított terméknevet.
ProductVersion	Lekéri az alkalmazáshoz társított termékverziót.
RenderWithVisualStyles	Beolvas egy értéket, amely megadja, hogy az aktuális alkalmazás vizuális stílusokkal rendelkező rajzvezérlők-e.
SafeTopLevelCaptionFormat	Lekéri vagy beállítja a formázási sztringet, hogy a felső szintű ablakfeliratokra vonatkozzanak, amikor figyelmeztető szalagcímmel jelennek meg.
StartupPath	Lekéri az alkalmazást elindító végrehajtható fájl elérési útját, a végrehajtható nevet nem beleértve.
SystemColorMode	Lekéri az operációsrendszer-rendszerkörnyezet rendszerszínmód-beállítását.
UserAppDataPath	Lekéri egy felhasználó alkalmazásadatainak elérési útját.
UserAppDataRegistry	Lekéri egy felhasználó alkalmazásadataihoz tartozó beállításkulcsot.
UseVisualStyles	Beolvas egy értéket, amely jelzi, hogy engedélyezve vannak-e a vizuális stílusok az alkalmazáshoz.
UseWaitCursor	Lekérdezi vagy beállítja, hogy a várakozási kurzor az alkalmazás összes megnyitott formájához használható-e.
VisualStyleState	Beolvas egy értéket, amely meghatározza, hogyan alkalmazzák a vizualizációs stílusokat az alkalmazásablakokra.

Metódusok

Name	Description
AddMessageFilter(IMessageFilter)	Egy üzenetszűrőt ad hozzá, amely figyeli Windows üzeneteket, miközben a céljukra irányítják őket.
DoEvents()	Feldolgozza az üzenetsorban jelenleg Windows üzeneteket.
EnableVisualStyles()	Engedélyezi az alkalmazás vizuális stílusainak használatát.
Exit()	Tájékoztatja az összes üzenetpumpát, hogy le kell mondaniuk, majd bezárja az összes alkalmazásablakot az üzenetek feldolgozása után.
Exit(CancelEventArgs)	Tájékoztatja az összes üzenetpumpát, hogy le kell mondaniuk, majd bezárja az összes alkalmazásablakot az üzenetek feldolgozása után.
ExitThread()	Kilép az aktuális szál üzenethurkból, és bezárja a szál összes ablakát.
FilterMessage(Message)	Futtatja a szűrőket egy ablaküzeneten, és visszaadja a módosított üzenet másolatát.
OleRequired()	Inicializálja az OLE-t az aktuális szálon.
OnThreadException(Exception)	Az eseményt emeli ThreadException ki.
RaiseIdle(EventArgs)	Az eseményt üzemeltetett Idle forgatókönyvekben emeli ki.
RegisterMessageLoop(Application+MessageLoopCallback)	Visszahívást regisztrál annak ellenőrzéséhez, hogy az üzenethurok üzemeltetett környezetben fut-e.
RemoveMessageFilter(IMessageFilter)	Eltávolít egy üzenetszűrőt az alkalmazás üzenetszivattyújából.
Restart()	Leállítja az alkalmazást, és azonnal elindít egy új példányt.
Run()	Egy szabványos alkalmazásüzenet-ciklus futtatását kezdi meg az aktuális szálon űrlap nélkül.
Run(ApplicationContext)	Egy szabványos alkalmazásüzenet-ciklus futtatását kezdi meg az aktuális szálon egy ApplicationContext.
Run(Form)	Megkezdi egy szabványos alkalmazásüzenet-ciklus futtatását az aktuális szálon, és láthatóvá teszi a megadott űrlapot.
SetColorMode(SystemColorMode)	Beállítja az alkalmazás alapértelmezett színmódját (sötét módot).
SetCompatibleTextRenderingDefault(Boolean)	Beállítja az alkalmazásszintű alapértelmezett beállítást az UseCompatibleTextRendering egyes vezérlőkön definiált tulajdonsághoz.
SetDefaultFont(Font)	Beállítja a folyamat alapértelmezett értékét Font .
SetHighDpiMode(HighDpiMode)	Beállítja a folyamat magas DPI-módját.
SetSuspendState(PowerState, Boolean, Boolean)	Felfüggeszti vagy hibernálja a rendszert, vagy kéri a rendszer felfüggesztését vagy hibernálását.
SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean)	Arra utasítja az alkalmazást, hogy reagáljon a kezeletlen kivételekre, és opcionálisan alkalmazza a szálspecifikus viselkedést.
SetUnhandledExceptionMode(UnhandledExceptionMode)	Arra utasítja az alkalmazást, hogy reagáljon a kezeletlen kivételekre.
UnregisterMessageLoop()	Törölje a regisztrációt a következővel létrehozott üzenethurok-visszahívás regisztrációjával RegisterMessageLoop(Application+MessageLoopCallback): .

esemény

Name	Description
ApplicationExit	Akkor fordul elő, amikor az alkalmazás le fog állni.
EnterThreadModal	Akkor fordul elő, ha az alkalmazás modális állapotba kerül.
Idle	Ez akkor fordul elő, ha az alkalmazás befejezi a feldolgozást, és az üresjárati állapot megadására készül.
LeaveThreadModal	Akkor fordul elő, ha az alkalmazás modális állapotot kíván hagyni.
ThreadException	Le nem képezett szálkivétel esetén fordul elő.
ThreadExit	Akkor fordul elő, ha egy szál le fog állni. Amikor egy alkalmazás fő szála le lesz állítva, a rendszer először ezt az eseményt emeli ki, majd egy ApplicationExit eseményt.