Application Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona static métodos y propiedades para administrar una aplicación, como métodos para iniciar y detener una aplicación, procesar Windows mensajes y propiedades para obtener información sobre una aplicación. Esta clase no puede heredarse.
public ref class Application sealed
public sealed class Application
type Application = class
Public NotInheritable Class Application
- Herencia
-
Application
Ejemplos
En el ejemplo de código siguiente se enumeran los números de un cuadro de lista de un formulario. Cada vez que haga clic en button1, la aplicación agrega otro número a la lista.
El Main método llama Run a para iniciar la aplicación, que crea el formulario listBox1 y button1. Cuando el usuario hace button1clic en , el button1_Click método muestra un MessageBox. Si el usuario hace No clic en MessageBox, el button1_Click método agrega un número a la lista. Si el usuario hace clic en Yes, la aplicación llama Exit a para procesar todos los mensajes restantes de la cola y, a continuación, para salir.
Note
La llamada a Exit producirá un error en la confianza parcial.
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
Comentarios
La clase />
Run inicia un bucle de mensajes de aplicación en el subproceso actual y, opcionalmente, hace que un formulario sea visible.
Exit o ExitThread detiene un bucle de mensajes.
DoEvents procesa mensajes mientras el programa está en un bucle.
AddMessageFilter agrega un filtro de mensajes a la bomba de mensajes de la aplicación para supervisar Windows mensajes.
IMessageFilter permite impedir que se genere un evento o realice operaciones especiales antes de invocar un controlador de eventos.
Esta clase tiene CurrentCulture propiedades y CurrentInputLanguage para obtener o establecer información de referencia cultural para el subproceso actual.
No se puede crear una instancia de esta clase.
Propiedades
| Nombre | Description |
|---|---|
| AllowQuit |
Obtiene un valor que indica si el autor de la llamada puede salir de esta aplicación. |
| CommonAppDataPath |
Obtiene la ruta de acceso de los datos de la aplicación que se comparten entre todos los usuarios. |
| CommonAppDataRegistry |
Obtiene la clave del Registro para los datos de la aplicación que se comparten entre todos los usuarios. |
| CompanyName |
Obtiene el nombre de la compañía asociado a la aplicación. |
| CurrentCulture |
Obtiene o establece la información de referencia cultural del subproceso actual. |
| CurrentInputLanguage |
Obtiene o establece el idioma de entrada actual para el subproceso actual. |
| ExecutablePath |
Obtiene la ruta de acceso del archivo ejecutable que inició la aplicación, incluido el nombre del archivo ejecutable. |
| LocalUserAppDataPath |
Obtiene la ruta de acceso de los datos de la aplicación de un usuario local que no es móvil. |
| MessageLoop |
Obtiene un valor que indica si existe un bucle de mensajes en este subproceso. |
| OpenForms |
Obtiene una colección de formularios abiertos propiedad de la aplicación. |
| ProductName |
Obtiene el nombre del producto asociado a esta aplicación. |
| ProductVersion |
Obtiene la versión del producto asociada a esta aplicación. |
| RenderWithVisualStyles |
Obtiene un valor que especifica si la aplicación actual está dibujando controles con estilos visuales. |
| SafeTopLevelCaptionFormat |
Obtiene o establece la cadena de formato que se va a aplicar a los títulos de ventana de nivel superior cuando se muestran con un banner de advertencia. |
| StartupPath |
Obtiene la ruta de acceso del archivo ejecutable que inició la aplicación, no incluido el nombre del archivo ejecutable. |
| UserAppDataPath |
Obtiene la ruta de acceso de los datos de la aplicación de un usuario. |
| UserAppDataRegistry |
Obtiene la clave del Registro para los datos de la aplicación de un usuario. |
| UseWaitCursor |
Obtiene o establece si el cursor de espera se usa para todos los formularios abiertos de la aplicación. |
| VisualStyleState |
Obtiene un valor que especifica cómo se aplican los estilos visuales a las ventanas de aplicación. |
Métodos
| Nombre | Description |
|---|---|
| AddMessageFilter(IMessageFilter) |
Agrega un filtro de mensajes para supervisar Windows mensajes a medida que se enrutan a sus destinos. |
| DoEvents() |
Procesa todos los mensajes Windows actualmente en la cola de mensajes. |
| EnableVisualStyles() |
Habilita los estilos visuales de la aplicación. |
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| Exit() |
Informa a todas las bombas de mensajes que deben finalizar y, a continuación, cierra todas las ventanas de aplicación después de procesar los mensajes. |
| Exit(CancelEventArgs) |
Informa a todas las bombas de mensajes que deben finalizar y, a continuación, cierra todas las ventanas de aplicación después de procesar los mensajes. |
| ExitThread() |
Sale del bucle de mensajes en el subproceso actual y cierra todas las ventanas del subproceso. |
| FilterMessage(Message) |
Ejecuta los filtros en un mensaje de ventana y devuelve una copia del mensaje modificado. |
| GetHashCode() |
Actúa como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| OleRequired() |
Inicializa OLE en el subproceso actual. |
| OnThreadException(Exception) |
Genera el evento ThreadException. |
| RaiseIdle(EventArgs) |
Genera el Idle evento en escenarios hospedados. |
| RegisterMessageLoop(Application+MessageLoopCallback) |
Registra una devolución de llamada para comprobar si el bucle de mensajes se ejecuta en entornos hospedados. |
| RemoveMessageFilter(IMessageFilter) |
Quita un filtro de mensaje de la bomba de mensajes de la aplicación. |
| Restart() |
Cierra la aplicación e inicia inmediatamente una nueva instancia. |
| Run() |
Comienza a ejecutar un bucle de mensajes de aplicación estándar en el subproceso actual, sin un formulario. |
| Run(ApplicationContext) |
Comienza a ejecutar un bucle de mensajes de aplicación estándar en el subproceso actual, con un ApplicationContext. |
| Run(Form) |
Comienza a ejecutar un bucle de mensajes de aplicación estándar en el subproceso actual y hace que el formulario especificado sea visible. |
| SetCompatibleTextRenderingDefault(Boolean) |
Establece el valor predeterminado de toda la aplicación para la |
| SetSuspendState(PowerState, Boolean, Boolean) |
Suspende o hiberna el sistema o solicita que el sistema se suspenda o hiberna. |
| SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean) |
Indica a la aplicación cómo responder a excepciones no controladas, aplicando opcionalmente un comportamiento específico del subproceso. |
| SetUnhandledExceptionMode(UnhandledExceptionMode) |
Indica a la aplicación cómo responder a excepciones no controladas. |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
| UnregisterMessageLoop() |
Anula el registro de la devolución de llamada de bucle de mensajes realizada con RegisterMessageLoop(Application+MessageLoopCallback). |
Eventos
| Nombre | Description |
|---|---|
| ApplicationExit |
Se produce cuando la aplicación está a punto de apagarse. |
| EnterThreadModal |
Se produce cuando la aplicación está a punto de especificar un estado modal. |
| Idle |
Se produce cuando la aplicación finaliza el procesamiento y está a punto de entrar en el estado de inactividad. |
| LeaveThreadModal |
Se produce cuando la aplicación está a punto de dejar un estado modal. |
| ThreadException |
Se produce cuando se produce una excepción de subproceso sintratrar. |
| ThreadExit |
Se produce cuando un subproceso está a punto de apagarse. Cuando el subproceso principal de una aplicación está a punto de apagarse, este evento se genera primero, seguido de un ApplicationExit evento. |