Application Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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 No på MessageBoxbutton1_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 |
| 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. |