Application Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan static
metode dan properti untuk mengelola aplikasi, seperti metode untuk memulai dan menghentikan aplikasi, untuk memproses pesan Windows, dan properti untuk mendapatkan informasi tentang aplikasi. Kelas ini tidak dapat diwariskan.
public ref class Application sealed
public sealed class Application
type Application = class
Public NotInheritable Class Application
- Warisan
-
Application
Contoh
Contoh kode berikut mencantumkan angka dalam kotak daftar pada formulir. Setiap kali Anda mengklik button1
, aplikasi menambahkan nomor lain ke daftar.
Metode ini Main
memanggil Run untuk memulai aplikasi, yang membuat formulir, listBox1
dan button1
. Saat pengguna mengklik button1
, button1_Click
metode menampilkan MessageBox. Jika pengguna mengklik No
MessageBox, button1_Click
metode menambahkan angka ke daftar. Jika pengguna mengklik Yes
, aplikasi memanggil Exit untuk memproses semua pesan yang tersisa dalam antrean lalu keluar.
Catatan
Panggilan ke Exit akan gagal dalam kepercayaan parsial.
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
Keterangan
Kelas Application ini memiliki metode untuk memulai dan menghentikan aplikasi dan utas, dan untuk memproses pesan Windows, sebagai berikut:
Run memulai perulangan pesan aplikasi pada utas saat ini dan, secara opsional, membuat formulir terlihat.
Exit atau ExitThread menghentikan perulangan pesan.
DoEvents memproses pesan saat program Anda berada dalam perulangan.
AddMessageFilter menambahkan filter pesan ke pompa pesan aplikasi untuk memantau pesan Windows.
IMessageFilter memungkinkan Anda menghentikan acara agar tidak dinaikkan atau melakukan operasi khusus sebelum memanggil penanganan aktivitas.
Kelas ini memiliki CurrentCulture properti dan CurrentInputLanguage untuk mendapatkan atau mengatur informasi budaya untuk utas saat ini.
Anda tidak dapat membuat instans kelas ini.
Properti
AllowQuit |
Mendapatkan nilai yang menunjukkan apakah penelepon dapat keluar dari aplikasi ini. |
ColorMode |
Menyediakan |
CommonAppDataPath |
Mendapatkan jalur untuk data aplikasi yang dibagikan di antara semua pengguna. |
CommonAppDataRegistry |
Mendapatkan kunci registri untuk data aplikasi yang dibagikan di antara semua pengguna. |
CompanyName |
Mendapatkan nama perusahaan yang terkait dengan aplikasi. |
CurrentCulture |
Mendapatkan atau mengatur informasi budaya untuk utas saat ini. |
CurrentInputLanguage |
Mendapatkan atau mengatur bahasa input saat ini untuk utas saat ini. |
ExecutablePath |
Mendapatkan jalur untuk file yang dapat dieksekusi yang memulai aplikasi, termasuk nama yang dapat dieksekusi. |
HighDpiMode |
Mendapatkan mode DPI tinggi saat ini untuk aplikasi. |
IsDarkModeEnabled |
Menyediakan |
LocalUserAppDataPath |
Mendapatkan jalur untuk data aplikasi pengguna lokal dan non-roaming. |
MessageLoop |
Mendapatkan nilai yang menunjukkan apakah perulangan pesan ada di utas ini. |
OpenForms |
Mendapatkan koleksi formulir terbuka yang dimiliki oleh aplikasi. |
ProductName |
Mendapatkan nama produk yang terkait dengan aplikasi ini. |
ProductVersion |
Mendapatkan versi produk yang terkait dengan aplikasi ini. |
RenderWithVisualStyles |
Mendapatkan nilai yang menentukan apakah aplikasi saat ini menggambar kontrol dengan gaya visual. |
SafeTopLevelCaptionFormat |
Mendapatkan atau mengatur string format untuk diterapkan ke keterangan jendela tingkat atas saat ditampilkan dengan banner peringatan. |
StartupPath |
Mendapatkan jalur untuk file yang dapat dieksekusi yang memulai aplikasi, tidak termasuk nama yang dapat dieksekusi. |
SystemColorMode |
Menyediakan |
UserAppDataPath |
Mendapatkan jalur untuk data aplikasi pengguna. |
UserAppDataRegistry |
Mendapatkan kunci registri untuk data aplikasi pengguna. |
UseVisualStyles |
Mendapatkan nilai yang menunjukkan apakah gaya visual diaktifkan untuk aplikasi. |
UseWaitCursor |
Mendapatkan atau mengatur apakah kursor tunggu digunakan untuk semua bentuk aplikasi yang terbuka. |
VisualStyleState |
Mendapatkan nilai yang menentukan bagaimana gaya visual diterapkan ke jendela aplikasi. |
Metode
AddMessageFilter(IMessageFilter) |
Menambahkan filter pesan untuk memantau pesan Windows saat dirutekan ke tujuannya. |
DoEvents() |
Memproses semua pesan Windows yang saat ini berada dalam antrean pesan. |
EnableVisualStyles() |
Mengaktifkan gaya visual untuk aplikasi. |
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
Exit() |
Menginformasikan semua pompa pesan bahwa mereka harus dihentikan, dan kemudian menutup semua jendela aplikasi setelah pesan diproses. |
Exit(CancelEventArgs) |
Menginformasikan semua pompa pesan bahwa mereka harus dihentikan, dan kemudian menutup semua jendela aplikasi setelah pesan diproses. |
ExitThread() |
Keluar dari perulangan pesan pada utas saat ini dan menutup semua jendela pada utas. |
FilterMessage(Message) |
Menjalankan filter apa pun terhadap pesan jendela, dan mengembalikan salinan pesan yang dimodifikasi. |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetType() |
Mendapatkan instans Type saat ini. (Diperoleh dari Object) |
MemberwiseClone() |
Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object) |
OleRequired() |
Menginisialisasi OLE pada utas saat ini. |
OnThreadException(Exception) |
Memunculkan kejadian ThreadException. |
RaiseIdle(EventArgs) |
Meningkatkan peristiwa dalam skenario yang Idle dihosting. |
RegisterMessageLoop(Application+MessageLoopCallback) |
Mendaftarkan panggilan balik untuk memeriksa apakah perulangan pesan berjalan di lingkungan yang dihosting. |
RemoveMessageFilter(IMessageFilter) |
Menghapus filter pesan dari pompa pesan aplikasi. |
Restart() |
Mematikan aplikasi dan segera memulai instans baru. |
Run() |
Mulai menjalankan perulangan pesan aplikasi standar pada utas saat ini, tanpa formulir. |
Run(ApplicationContext) |
Mulai menjalankan perulangan pesan aplikasi standar pada utas saat ini, dengan ApplicationContext. |
Run(Form) |
Mulai menjalankan perulangan pesan aplikasi standar pada utas saat ini, dan membuat formulir yang ditentukan terlihat. |
SetColorMode(SystemColorMode) |
Menyediakan |
SetCompatibleTextRenderingDefault(Boolean) |
Mengatur default seluruh aplikasi untuk properti yang |
SetDefaultFont(Font) |
Mengatur default Font untuk proses. |
SetHighDpiMode(HighDpiMode) |
Mengatur mode DPI tinggi dari proses. |
SetSuspendState(PowerState, Boolean, Boolean) |
Menangguhkan atau menghibernasi sistem, atau meminta sistem ditangguhkan atau dihibernasi. |
SetUnhandledExceptionMode(UnhandledExceptionMode) |
Menginstruksikan aplikasi cara menanggapi pengecualian yang tidak tertangani. |
SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean) |
Menginstruksikan aplikasi cara menanggapi pengecualian yang tidak tertangani, secara opsional menerapkan perilaku khusus utas. |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
UnregisterMessageLoop() |
Membatalkan pendaftaran panggilan balik perulangan pesan yang dibuat dengan RegisterMessageLoop(Application+MessageLoopCallback). |
Acara
ApplicationExit |
Terjadi ketika aplikasi akan dimatikan. |
EnterThreadModal |
Terjadi ketika aplikasi akan memasuki status modal. |
Idle |
Terjadi ketika aplikasi selesai diproses dan akan memasuki status menganggur. |
LeaveThreadModal |
Terjadi ketika aplikasi akan meninggalkan status modal. |
ThreadException |
Terjadi ketika pengecualian utas yang tidak ditarik dilemparkan. |
ThreadExit |
Terjadi ketika utas akan dimatikan. Ketika utas utama untuk aplikasi akan dimatikan, peristiwa ini dinaikkan terlebih dahulu, diikuti oleh peristiwa ApplicationExit . |