CoreApplication 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í.
Permite a las aplicaciones controlar los cambios de estado, administrar ventanas e integrarse con una variedad de marcos de interfaz de usuario.
public ref class CoreApplication abstract sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreApplication final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class CoreApplicationPublic Class CoreApplication- Herencia
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
|
Comentarios
El sistema crea este objeto como singleton cuando ejecuta la aplicación. Se ejecuta como application Single-Threaded Apartment (ASTA). Los subprocesos creados a partir del singleton de la aplicación, como el proveedor de vistas (visto en el ejemplo siguiente), se deben atribuir como Multi-Threaded Apartment (MTAThread).
Esta API solo se admite en Plataforma universal de Windows aplicaciones, excepto en la propiedad Properties, que siempre está disponible.
struct App : implements<App, IFrameworkViewSource, IFrameworkView>
{
public:
IFrameworkView CreateView()
{
return *this;
}
};
...
int __stdcall wWinMain(HINSTANCE, HINSTANCE, PWSTR, int)
{
Windows::ApplicationModel::Core::CoreApplication::Run(App());
}
ref class MyFrameworkViewSource : IFrameworkViewSource
{
public:
virtual IFrameworkView^ CreateView()
{
return ref new MyFrameworkView();
}
};
// ...
[Platform::MTAThread]
int main(Platform::Array<Platform::String^>^)
{
auto frameworkViewSource = ref new MyFrameworkViewSource();
Windows::ApplicationModel::Core::CoreApplication::Run(frameworkViewSource);
return 0;
}
internal class ApplicationSource : IFrameworkViewSource
{
public virtual IFrameworkView CreateView()
{
return new CoreApp();
}
}
...
[MTAThread]
public static int Main()
{
var appSource = new ApplicationSource();
CoreApplication.Run(appSource);
return 0;
}
Historial de versiones
| Versión de Windows | Versión del SDK | Valor agregado |
|---|---|---|
| 1607 | 14393 | BackgroundActivated |
| 1607 | 14393 | EnablePrelaunch |
| 1607 | 14393 | EnteredBackground |
| 1607 | 14393 | LeavingBackground |
| 1709 | 16299 | RequestRestartAsync |
| 1709 | 16299 | RequestRestartForUserAsync |
Propiedades
| Id |
Obtiene el identificador de aplicación relativa al paquete para el proceso. |
| MainView |
Obtiene la instancia principal de CoreApplicationView para todas las aplicaciones en ejecución que usan esta instancia de CoreApplication . |
| Properties |
Obtiene un conjunto de propiedades que las plataformas de la aplicación y la interfaz de usuario pueden usar para almacenar información mientras se ejecuta el proceso. |
| Views |
Obtiene todas las vistas de la aplicación. |
Métodos
| CreateNewView() |
Crea una nueva vista para la aplicación. |
| CreateNewView(IFrameworkViewSource) |
Crea una nueva vista para la aplicación. |
| CreateNewView(String, String) |
Crea una nueva vista para la aplicación. |
| DecrementApplicationUseCount() |
Disminuye el recuento total de instancias de aplicación en ejecución que usan esta instancia de CoreApplication . |
| EnablePrelaunch(Boolean) |
Habilite o deshabilite la capacidad del sistema operativo para iniciar previamente la aplicación. |
| Exit() |
Apaga la aplicación. |
| GetCurrentView() |
Obtiene la vista correspondiente al subproceso actual. |
| IncrementApplicationUseCount() |
Incrementa el recuento total de instancias de aplicación en ejecución que usan esta instancia de CoreApplication . |
| RequestRestartAsync(String) |
Reinicie la aplicación. |
| RequestRestartForUserAsync(User, String) |
Reinicie la aplicación en el contexto de un usuario diferente. |
| Run(IFrameworkViewSource) |
Ejecuta un generador de proveedores de vistas externo para obtener un proveedor de vistas. |
| RunWithActivationFactories(IGetActivationFactory) |
Ejecuta un generador de tipos activable para obtener un tipo activable externo. |
Eventos
| BackgroundActivated |
Se desencadena cuando un desencadenador en segundo plano activa la aplicación. |
| EnteredBackground |
Se desencadena cuando la aplicación entra en ejecución en el estado en segundo plano. |
| Exiting |
Se produce cuando la aplicación se apaga. |
| LeavingBackground |
Se desencadena justo antes de que la interfaz de usuario de la aplicación sea visible. |
| Resuming |
Se produce cuando se reanuda una aplicación. |
| Suspending |
Se produce cuando la aplicación se suspende. |
| UnhandledErrorDetected |
Se produce cuando hay un error subyacente que se enruta a la instancia de CoreApplication , como parte de la lógica global de control de errores. |