Application Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje static
metody a vlastnosti pro správu aplikace, například metody pro spuštění a zastavení aplikace, zpracování zpráv systému Windows a vlastnosti 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
-
Application
Příklady
Následující příklad kódu uvádí čísla v seznamu ve formuláři. Pokaždé, když kliknete na button1
, přidá aplikace do seznamu další číslo.
Volání Main
metody Run ke spuštění aplikace, která vytvoří formulář, listBox1
a button1
. Když uživatel klikne na 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 na Yes
, aplikace zavolá Exit , aby zpracová všechny zbývající zprávy ve frontě a pak se ukončila.
Poznámka
Volání Exit se 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í zpráv systému Windows 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á filtr zpráv do čerpadla zpráv aplikace pro monitorování zpráv systému Windows.
IMessageFilter umožňuje zastavit vyvolání události nebo provedení speciálních operací před vyvoláním obslužné rutiny události.
Tato třída má CurrentCulture vlastnosti a CurrentInputLanguage pro získání nebo nastavení informací o jazykové verzi pro aktuální vlákno.
Nelze vytvořit instanci této třídy.
Vlastnosti
AllowQuit |
Získá hodnotu označující, zda volající může ukončit tuto aplikaci. |
ColorMode |
Poskytuje |
CommonAppDataPath |
Získá cestu pro data aplikace, která je sdílena mezi všemi uživateli. |
CommonAppDataRegistry |
Získá klíč registru pro data aplikace, která je 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ý spustil aplikaci, včetně názvu spustitelného souboru. |
HighDpiMode |
Získá aktuální režim vysoké DPI pro aplikaci. |
IsDarkModeEnabled |
Poskytuje |
LocalUserAppDataPath |
Získá cestu pro data aplikace místního uživatele bez roamingu. |
MessageLoop |
Získá hodnotu označující, zda existuje smyčka zpráv 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ého 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 výkres ovládací prvky s vizuální styly. |
SafeTopLevelCaptionFormat |
Získá nebo nastaví řetězec formátu, aby se použil na titulky okna nejvyšší úrovně, když jsou zobrazeny s upozorněním banner. |
StartupPath |
Získá cestu ke spustitelnému souboru, který spustil aplikaci, bez názvu spustitelného souboru. |
SystemColorMode |
Poskytuje |
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 vizuální styly jsou povoleny pro aplikaci. |
UseWaitCursor |
Získá nebo nastaví, zda je kurzor čekání použit pro všechny otevřené formuláře aplikace. |
VisualStyleState |
Získá hodnotu, která určuje, jak vizuální styly jsou použity na okna aplikace. |
Metody
AddMessageFilter(IMessageFilter) |
Přidá filtr zpráv pro monitorování zpráv systému Windows, když jsou směrovány do cíle. |
DoEvents() |
Zpracovává všechny zprávy systému Windows, které jsou aktuálně ve frontě zpráv. |
EnableVisualStyles() |
Povolí vizuální styly pro aplikaci. |
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
Exit() |
Informuje všechny zprávy o tom, že musí být ukončeny, a poté zavře všechna okna aplikací po zpracování zpráv. |
Exit(CancelEventArgs) |
Informuje všechny zprávy o tom, že musí být ukončeny, a poté zavře všechna okna aplikací po zpracování zpráv. |
ExitThread() |
Ukončí smyčku zpráv na 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. |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
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 je smyčka zpráv spuštěná v hostovaných prostředích. |
RemoveMessageFilter(IMessageFilter) |
Odebere filtr zpráv z pumpy zpráv aplikace. |
Restart() |
Vypne aplikaci a okamžitě spustí novou instanci. |
Run() |
Spustí standardní smyčku zpráv aplikace v aktuálním vlákně bez formuláře. |
Run(ApplicationContext) |
Začne v aktuálním vlákně spouštět standardní smyčku zpráv aplikace.ApplicationContext |
Run(Form) |
Spustí standardní smyčku zpráv aplikace v aktuálním vlákně a zviditelní zadaný formulář. |
SetColorMode(SystemColorMode) |
Poskytuje |
SetCompatibleTextRenderingDefault(Boolean) |
Nastaví výchozí hodnotu pro celou aplikaci pro vlastnost definovanou |
SetDefaultFont(Font) |
Nastaví výchozí hodnotu Font pro proces. |
SetHighDpiMode(HighDpiMode) |
Nastaví režim procesu s vysokým rozlišením DPI. |
SetSuspendState(PowerState, Boolean, Boolean) |
Pozastaví nebo přepíná systém do režimu hibernace nebo požádá o pozastavení nebo hibernaci systému. |
SetUnhandledExceptionMode(UnhandledExceptionMode) |
Dává aplikaci pokyn, jak reagovat na neošetřené výjimky. |
SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean) |
Instruuje aplikaci, jak reagovat na neošetřené výjimky, případně použít chování specifické pro vlákna. |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
UnregisterMessageLoop() |
Zruší registraci zpětného volání smyčky zpráv provedené pomocí RegisterMessageLoop(Application+MessageLoopCallback). |
Událost
ApplicationExit |
Nastane, když se aplikace chystá vypnout. |
EnterThreadModal |
Nastane, když se aplikace chystá přejít do modálního stavu. |
Idle |
Nastane, když aplikace dokončí zpracování a chystá se přejít do stavu nečinnosti. |
LeaveThreadModal |
Nastane, když se aplikace chystá opustit modální stav. |
ThreadException |
Nastane při vyvolání výjimky z netažených vláken. |
ThreadExit |
Nastane, když se vlákno chystá vypnout. Když se hlavní vlákno aplikace chystá vypnout, vyvolá se tato událost jako první a potom událost ApplicationExit . |