Application Klass

Definition

Innehåller static metoder och egenskaper för att hantera ett program, till exempel metoder för att starta och stoppa ett program, för att bearbeta Windows meddelanden och egenskaper för att få information om ett program. Det går inte att ärva den här klassen.

public ref class Application sealed
public sealed class Application
type Application = class
Public NotInheritable Class Application
Arv
Application

Exempel

I följande kodexempel visas siffror i en listruta i ett formulär. Varje gång du klickar lägger button1programmet till ytterligare ett tal i listan.

Metoden Main anropar Run för att starta programmet, som skapar formuläret och listBox1button1. När användaren klickar button1button1_Click visar metoden en MessageBox. Om användaren klickar NoMessageBoxbutton1_Click lägger metoden till ett tal i listan. Om användaren klickar anropar YesExit programmet för att bearbeta alla återstående meddelanden i kön och sedan avsluta.

Note

Anropet till Exit misslyckas i partiellt förtroende.

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

Kommentarer

Klassen Application har metoder för att starta och stoppa program och trådar och bearbeta Windows meddelanden på följande sätt:

  • Run startar en programmeddelandeslinga på den aktuella tråden och kan också göra ett formulär synligt.

  • Exit eller ExitThread stoppar en meddelandeloop.

  • DoEvents bearbetar meddelanden medan programmet finns i en loop.

  • AddMessageFilter lägger till ett meddelandefilter i programmeddelandepumpen för att övervaka Windows meddelanden.

  • IMessageFilter låter dig stoppa en händelse från att aktiveras eller utföra särskilda åtgärder innan du anropar en händelsehanterare.

Den här klassen har CurrentCulture och CurrentInputLanguage egenskaper för att hämta eller ange kulturinformation för den aktuella tråden.

Du kan inte skapa en instans av den här klassen.

Egenskaper

Name Description
AllowQuit

Hämtar ett värde som anger om anroparen kan avsluta programmet.

ColorMode

Hämtar standardfärgläget (mörkt läge) för programmet.

CommonAppDataPath

Hämtar sökvägen för programdata som delas mellan alla användare.

CommonAppDataRegistry

Hämtar registernyckeln för programdata som delas mellan alla användare.

CompanyName

Hämtar företagsnamnet som är associerat med programmet.

CurrentCulture

Hämtar eller anger kulturinformationen för den aktuella tråden.

CurrentInputLanguage

Hämtar eller anger det aktuella indataspråket för den aktuella tråden.

ExecutablePath

Hämtar sökvägen för den körbara fil som startade programmet, inklusive det körbara namnet.

HighDpiMode

Hämtar det aktuella höga DPI-läget för programmet.

IsDarkModeEnabled

Hämtar ett värde som anger om programmet körs i en mörk systemfärgkontext.

LocalUserAppDataPath

Hämtar sökvägen för programdata för en lokal, icke-roaming-användare.

MessageLoop

Hämtar ett värde som anger om det finns en meddelandeloop i den här tråden.

OpenForms

Hämtar en samling öppna formulär som ägs av programmet.

ProductName

Hämtar produktnamnet som är associerat med det här programmet.

ProductVersion

Hämtar den produktversion som är associerad med det här programmet.

RenderWithVisualStyles

Hämtar ett värde som anger om det aktuella programmet ritar kontroller med visuella format.

SafeTopLevelCaptionFormat

Hämtar eller anger formatsträngen som ska tillämpas på undertexter på den översta nivån när de visas med en varningsbanderoll.

StartupPath

Hämtar sökvägen för den körbara fil som startade programmet, inklusive det körbara namnet.

SystemColorMode

Hämtar systemfärglägesinställningen för os-systemmiljön.

UserAppDataPath

Hämtar sökvägen för en användares programdata.

UserAppDataRegistry

Hämtar registernyckeln för en användares programdata.

UseVisualStyles

Hämtar ett värde som anger om visuella format är aktiverade för programmet.

UseWaitCursor

Hämtar eller anger om väntemarkören används för alla öppna programformer.

VisualStyleState

Hämtar ett värde som anger hur visuella format tillämpas på programfönster.

Metoder

Name Description
AddMessageFilter(IMessageFilter)

Lägger till ett meddelandefilter för att övervaka Windows meddelanden när de dirigeras till sina mål.

DoEvents()

Bearbetar alla Windows meddelanden som för närvarande finns i meddelandekön.

EnableVisualStyles()

Aktiverar visuella format för programmet.

Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
Exit()

Informerar alla meddelandepumpar om att de måste avslutas och stänger sedan alla programfönster när meddelandena har bearbetats.

Exit(CancelEventArgs)

Informerar alla meddelandepumpar om att de måste avslutas och stänger sedan alla programfönster när meddelandena har bearbetats.

ExitThread()

Avslutar meddelandeloopen på den aktuella tråden och stänger alla fönster i tråden.

FilterMessage(Message)

Kör eventuella filter mot ett fönstermeddelande och returnerar en kopia av det ändrade meddelandet.

GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
OleRequired()

Initierar OLE på den aktuella tråden.

OnThreadException(Exception)

Genererar händelsen ThreadException .

RaiseIdle(EventArgs)

Genererar Idle händelsen i värdbaserade scenarier.

RegisterMessageLoop(Application+MessageLoopCallback)

Registrerar ett återanrop för att kontrollera om meddelandeloopen körs i värdbaserade miljöer.

RemoveMessageFilter(IMessageFilter)

Tar bort ett meddelandefilter från programmets meddelandepump.

Restart()

Stänger av programmet och startar en ny instans omedelbart.

Run()

Börjar köra en standardprogrammeddelandeloop i den aktuella tråden, utan formulär.

Run(ApplicationContext)

Börjar köra en standardprogrammeddelandeloop i den aktuella tråden med en ApplicationContext.

Run(Form)

Börjar köra en standardprogrammeddelandeloop i den aktuella tråden och gör det angivna formuläret synligt.

SetColorMode(SystemColorMode)

Anger standardfärgläget (mörkt läge) för programmet.

SetCompatibleTextRenderingDefault(Boolean)

Anger standardvärdet för hela programmet för egenskapen UseCompatibleTextRendering som definierats för vissa kontroller.

SetDefaultFont(Font)

Anger standardvärdet Font för processen.

SetHighDpiMode(HighDpiMode)

Anger processens höga DPI-läge.

SetSuspendState(PowerState, Boolean, Boolean)

Pausar eller viloläger systemet, eller begär att systemet ska pausas eller viloläge.

SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean)

Instruerar programmet hur man svarar på ohanterade undantag, om du vill tillämpa trådspecifikt beteende.

SetUnhandledExceptionMode(UnhandledExceptionMode)

Instruerar programmet att svara på ohanterade undantag.

ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
UnregisterMessageLoop()

Avregistrerar återanropet för meddelandeloopen med RegisterMessageLoop(Application+MessageLoopCallback).

Händelser

Name Description
ApplicationExit

Inträffar när programmet håller på att stängas av.

EnterThreadModal

Inträffar när programmet är på väg att ange ett modalt tillstånd.

Idle

Inträffar när programmet har slutfört bearbetningen och håller på att ange inaktivt tillstånd.

LeaveThreadModal

Inträffar när programmet är på väg att lämna ett modalt tillstånd.

ThreadException

Inträffar när ett ohört trådundanstag utlöses.

ThreadExit

Inträffar när en tråd håller på att stängas av. När huvudtråden för ett program håller på att stängas av aktiveras den här händelsen först, följt av en ApplicationExit händelse.

Gäller för