Application Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

Application.cs

Poskytuje static metody a vlastnosti pro správu aplikace, jako jsou metody spuštění a zastavení aplikace, zpracování Windows zpráv a vlastností pro získání informací o aplikaci. Tato třída se nemůže dědit.

public ref class Application sealed

public sealed class Application

type Application = class

Public NotInheritable Class Application

Dědičnost

Object

Application

Příklady

Následující příklad kódu uvádí čísla v seznamu ve formuláři. Pokaždé, když kliknete button1, aplikace přidá do seznamu další číslo.

Volání Main metody Run pro spuštění aplikace, která vytvoří formulář, listBox1 a button1. Když uživatel klikne button1, button1_Click metoda zobrazí MessageBox. Pokud uživatel klikne No na MessageBox, button1_Click metoda přidá číslo do seznamu. Pokud uživatel klikne Yes, aplikace volá Exit zpracování všech zbývajících zpráv ve frontě a ukončení.

Note

Volání se Exit nezdaří v částečném vztahu důvěryhodnosti.

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

Poznámky

Třída Application obsahuje metody pro spuštění a zastavení aplikací a vláken a zpracování Windows zpráv následujícím způsobem:

• Run spustí smyčku zpráv aplikace v aktuálním vlákně a volitelně zviditelní formulář.

• Exit nebo ExitThread zastaví smyčku zpráv.

• DoEvents zpracovává zprávy, když je program ve smyčce.

• AddMessageFilter přidá do pumpy zpráv aplikace filtr zpráv pro monitorování Windows zpráv.

• IMessageFilter umožňuje zastavit vyvolání události nebo provádění zvláštních operací před vyvoláním obslužné rutiny události.

Tato třída má CurrentCulture a CurrentInputLanguage vlastnosti pro získání nebo nastavení informací o jazykové verzi pro aktuální vlákno.

Nelze vytvořit instanci této třídy.

Vlastnosti

Name	Description
AllowQuit	Získá hodnotu určující, zda volající může ukončit tuto aplikaci.
ColorMode	Získá výchozí barevný režim (tmavý režim) pro aplikaci.
CommonAppDataPath	Získá cestu pro data aplikace, která jsou sdílena mezi všemi uživateli.
CommonAppDataRegistry	Získá klíč registru pro data aplikace, která jsou sdílena mezi všemi uživateli.
CompanyName	Získá název společnosti přidružené k aplikaci.
CurrentCulture	Získá nebo nastaví informace o jazykové verzi pro aktuální vlákno.
CurrentInputLanguage	Získá nebo nastaví aktuální jazyk zadávání pro aktuální vlákno.
ExecutablePath	Získá cestu ke spustitelnému souboru, který aplikaci spustil, včetně názvu spustitelného souboru.
HighDpiMode	Získá aktuální režim VYSOKÉHO DPI pro aplikaci.
IsDarkModeEnabled	Získá hodnotu určující, zda aplikace běží v tmavém systémovém barevném kontextu.
LocalUserAppDataPath	Získá cestu pro data aplikace místního ne roamingového uživatele.
MessageLoop	Získá hodnotu označující, zda smyčka zprávy existuje v tomto vlákně.
OpenForms	Získá kolekci otevřených formulářů vlastněných aplikací.
ProductName	Získá název produktu přidružený k této aplikaci.
ProductVersion	Získá verzi produktu přidruženou k této aplikaci.
RenderWithVisualStyles	Získá hodnotu určující, zda aktuální aplikace je kreslení ovládacích prvků s vizuálními styly.
SafeTopLevelCaptionFormat	Získá nebo nastaví formátovací řetězec, který se použije na titulky okna nejvyšší úrovně, když jsou zobrazeny s upozorněním banner.
StartupPath	Získá cestu ke spustitelnému souboru, který aplikaci spustil, a nezahrnuje název spustitelného souboru.
SystemColorMode	Získá nastavení režimu barev systému systémového prostředí operačního systému.
UserAppDataPath	Získá cestu pro data aplikace uživatele.
UserAppDataRegistry	Získá klíč registru pro data aplikace uživatele.
UseVisualStyles	Získá hodnotu, která označuje, zda jsou styly vizuálu povoleny pro aplikaci.
UseWaitCursor	Získá nebo nastaví, zda se kurzor čekání používá pro všechny otevřené formuláře aplikace.
VisualStyleState	Získá hodnotu, která určuje, jak se styly vizuálů použijí v oknech aplikací.

Metody

Name	Description
AddMessageFilter(IMessageFilter)	Přidá filtr zpráv pro monitorování Windows zpráv při jejich směrování do cílů.
DoEvents()	Zpracovává všechny Windows zprávy aktuálně ve frontě zpráv.
EnableVisualStyles()	Povolí vizuální styly pro aplikaci.
Exit()	Informuje všechna čerpadla zpráv, že se musí ukončit, a poté zavře všechna okna aplikace po zpracování zpráv.
Exit(CancelEventArgs)	Informuje všechna čerpadla zpráv, že se musí ukončit, a poté zavře všechna okna aplikace po zpracování zpráv.
ExitThread()	Ukončí smyčku zprávy v aktuálním vlákně a zavře všechna okna ve vlákně.
FilterMessage(Message)	Spustí všechny filtry pro zprávu okna a vrátí kopii upravené zprávy.
OleRequired()	Inicializuje OLE v aktuálním vlákně.
OnThreadException(Exception)	ThreadException Vyvolá událost.
RaiseIdle(EventArgs)	Idle Vyvolá událost v hostovaných scénářích.
RegisterMessageLoop(Application+MessageLoopCallback)	Zaregistruje zpětné volání pro kontrolu, jestli smyčka zpráv běží v hostovaných prostředích.
RemoveMessageFilter(IMessageFilter)	Odebere filtr zpráv z pumpy zprávy aplikace.
Restart()	Vypne aplikaci a okamžitě spustí novou instanci.
Run()	Začne spouštět standardní smyčku zpráv aplikace v aktuálním vlákně bez formuláře.
Run(ApplicationContext)	Začne spouštět standardní smyčku zpráv aplikace v aktuálním vlákně s hodnotou ApplicationContext.
Run(Form)	Začne spouštět standardní smyčku zpráv aplikace v aktuálním vlákně a zviditelní zadaný formulář.
SetColorMode(SystemColorMode)	Nastaví výchozí barevný režim (tmavý režim) pro aplikaci.
SetCompatibleTextRenderingDefault(Boolean)	Nastaví výchozí nastavení pro vlastnost definovanou UseCompatibleTextRendering v určitých ovládacích prvcích pro celou aplikaci.
SetDefaultFont(Font)	Nastaví výchozí hodnotu Font pro proces.
SetHighDpiMode(HighDpiMode)	Nastaví režim vysokého DPI procesu.
SetSuspendState(PowerState, Boolean, Boolean)	Pozastaví nebo hibernace systému nebo požádá o pozastavení nebo hibernaci systému.
SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean)	Dává aplikaci pokyn, jak reagovat na neošetřené výjimky a volitelně použít chování specifické pro vlákno.
SetUnhandledExceptionMode(UnhandledExceptionMode)	Dává aplikaci pokyn, jak reagovat na neošetřené výjimky.
UnregisterMessageLoop()	Zruší registraci zpětného volání smyčky zprávy provedené s RegisterMessageLoop(Application+MessageLoopCallback).

Událost

Name	Description
ApplicationExit	Nastane, když se aplikace chystá vypnout.
EnterThreadModal	Nastane, když se aplikace chystá zadat modální stav.
Idle	Nastane, když aplikace dokončí zpracování a chystá se zadat stav nečinnosti.
LeaveThreadModal	Nastane, když se aplikace chystá opustit modální stav.
ThreadException	Nastane v případě, že je vyvolána výjimka neztraceného vlákna.
ThreadExit	Nastane, když se vlákno chystá vypnout. Když se hlavní vlákno aplikace chystá vypnout, je tato událost vyvolána jako první následovaná událostí ApplicationExit .