CWinApp Class

Artículo
06/10/2015

La clase base que se deriva un objeto de aplicación para Windows.

class CWinApp : public CWinThread

Miembros

Constructores públicos

Name	Descripción
CWinApp::CWinApp	Crea un objeto CWinApp.

Métodos públicos

Name	Descripción
CWinApp::AddDocTemplate	Agrega una plantilla de documento a la lista de plantillas de documento disponibles.
CWinApp::AddToRecentFileList	Agrega un nombre de archivo a la lista de archivos usados recientemente utilizada (MRU).
CWinApp::ApplicationRecoveryCallback	Llamado por el marco cuando cierra la aplicación inesperado.
CWinApp::CloseAllDocuments	Cierra todos los documentos abiertos.
CWinApp::CreatePrinterDC	Crea un contexto de dispositivo de impresora.
CWinApp::DelRegTree	Elimina una clave especificada y todas sus subclaves.
CWinApp::DoMessageBox	implementa AfxMessageBox para la aplicación.
CWinApp::DoWaitCursor	Gira el cursor de espera por intervalos.
CWinApp::EnableD2DSupport	Compatibilidad de D2D de la aplicación de permisos. Llame a este método antes de que se inicialice la ventana principal.
CWinApp::EnableHtmlHelp	Implementa HTMLHelp para la aplicación, en lugar de WinHelp.
CWinApp::EnableTaskbarInteraction	Interacción de la barra de tareas de permisos.
CWinApp::ExitInstance	reemplace para limpiar cuando la aplicación finaliza.
CWinApp::GetApplicationRecoveryParameter	Recupera el parámetro de entrada para el método de recuperación de la aplicación.
CWinApp::GetApplicationRecoveryPingInterval	Devuelve el intervalo de tiempo que el administrador de reinicio espera la función de devolución de llamada de recuperación para devolver.
CWinApp::GetApplicationRestartFlags	Devuelve marcas para el administrador de reinicio.
CWinApp::GetAppRegistryKey	Devuelve la clave de HKEY_CURRENT_USER \"Software"\RegistryKey\ProfileName.
CWinApp::GetDataRecoveryHandler	Obtiene el controlador de la recuperación de datos para esta instancia de la aplicación.
CWinApp::GetFirstDocTemplatePosition	recupera la posición de la primera plantilla de documento.
CWinApp::GetHelpMode	recupera el tipo de ayuda utilizado por la aplicación.
CWinApp::GetNextDocTemplate	recupera la posición de una plantilla de documento. Se puede utilizar de forma recursiva.
CWinApp::GetPrinterDeviceDefaults	Recupera los valores predeterminados del dispositivo de impresora.
CWinApp::GetProfileBinary	Recupera datos binarios de una entrada en el archivo de .INI de la aplicación.
CWinApp::GetProfileInt	Recupera un entero de una entrada en el archivo de .INI de la aplicación.
CWinApp::GetProfileString	Recupera una cadena de una entrada en el archivo de .INI de la aplicación.
CWinApp::GetSectionKey	Devuelve la clave de HKEY_CURRENT_USER \"Software"\RegistryKey\AppName\lpszSection.
CWinApp::HideApplication	oculta la aplicación antes de cerrar todos los documentos.
CWinApp::HtmlHelp	Llama a la función de HTMLHelp Windows.
CWinApp::InitInstance	Reemplace para realizar la inicialización de la instancia de Windows, como crear los objetos de la ventana.
CWinApp::IsTaskbarInteractionEnabled	Indica si la interacción de la barra de tareas de Windows 7 está habilitada.
CWinApp::LoadCursor	Carga un recurso del cursor.
CWinApp::LoadIcon	Carga un recurso de icono.
CWinApp::LoadOEMCursor	Carga Windows cursor predefinido OEM que las constantes de OCR_ especificados en WINDOWS.H.
CWinApp::LoadOEMIcon	Carga un icono predefinido OEM de Windows que las constantes de OIC_ especificados en WINDOWS.H.
CWinApp::LoadStandardCursor	Carga el cursor predefinido Windows que las constantes de IDC_ especificados en WINDOWS.H.
CWinApp::LoadStandardIcon	Carga un icono predefinido Windows que las constantes de IDI_ especificados en WINDOWS.H.
CWinApp::OnDDECommand	Llamado por el marco en respuesta a un intercambio de datos dinámicos (DDE) ejecute el comando.
CWinApp::OnIdle	Reemplace para realizar el procesamiento específico de la aplicación en tiempo de inactividad.
CWinApp::OpenDocumentFile	Llamado por el marco para abrir un documento de un archivo.
CWinApp::ParseCommandLine	Analiza los parámetros individuales y marca en la línea de comandos.
CWinApp::PreTranslateMessage	Mensajes de filtros antes de que se envíen a las funciones de Windows TranslateMessage y DispatchMessage.
CWinApp::ProcessMessageFilter	Algunos mensajes de las intersecciones antes de que llegan a la aplicación.
CWinApp::ProcessShellCommand	Controla argumentos de la línea de comandos e indicadores.
CWinApp::ProcessWndProcException	Intercepta todas las excepciones no controladas producidas por los controladores de mensajes y el comando de la aplicación.
CWinApp::Register	performs personalizó el registro.
CWinApp::RegisterWithRestartManager	Registra la aplicación con el administrador de reinicio.
CWinApp::ReopenPreviousFilesAtRestart	Determina si el administrador de reinicio vuelve a abrir los archivos que se abren cuando fue la aplicación inesperado.
CWinApp::RestartInstance	Administra el reinicio de la aplicación inicia el administrador de reinicio.
CWinApp::RestoreAutosavedFilesAtRestart	Determina si el administrador de reinicio restaura los archivos autoguardados cuando se reinicia la aplicación.
CWinApp::Run	ejecuta el bucle de mensajes predeterminado. reemplace para personalizar el bucle de mensajes.
CWinApp::RunAutomated	prueba la línea de comandos de la aplicación para la opción de /Automation . Obsoleto. En su lugar, utilice el valor en CCommandLineInfo:: m_bRunAutomated después de llamar a ParseCommandLine.
CWinApp::RunEmbedded	prueba la línea de comandos de la aplicación para la opción de /Embedding . Obsoleto. En su lugar, utilice el valor en CCommandLineInfo:: m_bRunEmbedded después de llamar a ParseCommandLine.
CWinApp::SaveAllModified	Solicita al usuario guardar todos los documentos modificados.
CWinApp::SelectPrinter	Selecciona una impresora indicada anteriormente por un usuario a través de un cuadro de diálogo de impresión.
CWinApp::SetHelpMode	Los conjuntos y inicialice el tipo de ayuda utilizado por la aplicación.
CWinApp::SupportsApplicationRecovery	Determina si recupera el administrador de reinicio una aplicación que fue inesperado.
CWinApp::SupportsAutosaveAtInterval	Determina si el administrador de reinicio autoguarda documentos abiertos de manera periódica.
CWinApp::SupportsAutosaveAtRestart	Determina si el administrador de reinicio autoguarda los documentos abiertos cuando se reinicia la aplicación.
CWinApp::SupportsRestartManager	Determina si la aplicación es compatible con el administrador de reinicio.
CWinApp::Unregister	Anula todo conocida para registrarse por el objeto de CWinApp .
CWinApp::WinHelp	Llama a la función de WinHelp Windows.
CWinApp::WriteProfileBinary	Escribe datos binarios a una entrada en el archivo de .INI de la aplicación.
CWinApp::WriteProfileInt	Escriba un entero a una entrada en el archivo de .INI de la aplicación.
CWinApp::WriteProfileString	Escribe una cadena en una entrada en el archivo de .INI de la aplicación.

Métodos protegidos

Name	Descripción
CWinApp::EnableShellOpen	Permite que el usuario abre los archivos de datos del administrador de archivos de Windows.
CWinApp::LoadStdProfileSettings	Carga la configuración estándar del archivo de .INI y habilita la característica lista de archivos MRU.
CWinApp::OnContextHelp	Ayuda de identificadores MAYÚS+F1 dentro de la aplicación.
CWinApp::OnFileNew	Implementar el comando de ID_FILE_NEW .
CWinApp::OnFileOpen	Implementar el comando de ID_FILE_OPEN .
CWinApp::OnFilePrintSetup	Implementar el comando de ID_FILE_PRINT_SETUP .
CWinApp::OnHelp	Ayuda de F1 de identificadores dentro de la aplicación (con el contexto actual).
CWinApp::OnHelpFinder	Controla los comandos de ID_HELP_FINDER y de ID_DEFAULT_HELP .
CWinApp::OnHelpIndex	Administra el comando de ID_HELP_INDEX y proporciona un tema de Ayuda predeterminado.
CWinApp::OnHelpUsing	Controla el comando ID_HELP_USING.
CWinApp::RegisterShellFileTypes	registra los tipos de documento de toda la aplicación con el administrador de archivos de Windows.
CWinApp::SetAppID	Establece explícitamente el identificador del Modelo de usuario de la aplicación de la aplicación. Se debe llamar a este método antes de cualquier interfaz de usuario se muestra al usuario (el mejor lugar es el constructor de la aplicación).
CWinApp::SetRegistryKey	Hace que la configuración de la aplicación que se almacenarán en el registro en lugar de archivos de .INI.
CWinApp::UnregisterShellFileTypes	Anula los tipos de documento de toda la aplicación con el administrador de archivos de Windows.

Miembros de datos públicos

Name	Descripción
CWinApp::m_bHelpMode	Indica si el usuario está en el modo de contexto de Ayuda (invocado normalmente con MAYÚS+F1).
CWinApp::m_eHelpType	especifica el tipo de ayuda utilizado por la aplicación.
CWinApp::m_hInstance	identifica la instancia actual de la aplicación.
CWinApp::m_lpCmdLine	Señala una cadena terminada en null que especifica la línea de comandos para la aplicación.
CWinApp::m_nCmdShow	especifica cómo la ventana debe ser mostrada inicialmente.
CWinApp::m_pActiveWnd	Puntero a la ventana principal de la aplicación contenedora cuando un servidor OLE está activo en contexto.
CWinApp::m_pszAppID	Identificador del Modelo de usuario de la aplicación
CWinApp::m_pszAppName	Especifica el nombre de la aplicación.
CWinApp::m_pszExeName	El nombre del módulo de la aplicación.
CWinApp::m_pszHelpFilePath	La ruta de acceso al archivo de Ayuda de la aplicación.
CWinApp::m_pszProfileName	El nombre de archivo de .INI de la aplicación.
CWinApp::m_pszRegistryKey	Utilizado para determinar la clave del Registro completa para almacenar la configuración de perfil de la aplicación.

Miembros de datos protegidos

Name	Descripción
CWinApp::m_dwRestartManagerSupportFlags	Marca que determina cómo el administrador de reinicio se comporta.
CWinApp::m_nAutosaveInterval	El intervalo de tiempo en milisegundos entre los autoguardados.
CWinApp::m_pDataRecoveryHandler	Puntero al controlador de la recuperación de datos para la aplicación.

Comentarios

Un objeto de aplicación proporciona funciones miembro para inicializar la aplicación (y cada instancia de ella) y ejecutar la aplicación.

Cada aplicación que utiliza las clases de windows presentation foundation Microsoft sólo puede contener un objeto derivado de CWinApp. Este objeto se crea cuando se construyen otros objetos globales de C++ ya está disponible cuando Windows llama a la función de WinMain , proporcionada por la biblioteca Microsoft Foundation Class. declare el objeto derivado de CWinApp en el nivel global.

Al derivar una clase de aplicación de CWinApp, reemplace la función miembro de InitInstance para crear el objeto de la ventana principal de la aplicación.

Además de las funciones miembro de CWinApp , la biblioteca Microsoft Foundation Class proporciona funciones globales siguientes para tener acceso a CWinApp y a otra información global:

AfxGetApp Obtains un puntero al objeto de CWinApp .
AfxGetInstanceHandle Obtains un identificador de la instancia de aplicación actual.
AfxGetResourceHandle Obtains un identificador a los recursos de la aplicación.
AfxGetAppName Obtains un puntero a una cadena que contiene el nombre de la aplicación. Como alternativa, si tiene un puntero al objeto de CWinApp , utilice m_pszExeName de obtener el nombre de aplicación.

Vea CWinApp: La clase de aplicación para más en la clase de CWinApp , incluida una información general del siguiente:

CWinApp- código derivado escrito por el Asistente para aplicaciones.
el rol de los entity_CWinApp en la secuencia de la ejecución de la aplicación.
implementaciones predeterminadas de funciones miembro de los entity_CWinApp.
los overridables clave de los entity_CWinApp.

El miembro de datos de m_hPrevInstance ya no existe. Para obtener información sobre cómo detectar una instancia anterior de CWinApp, vea el artículo “Cómo de Knowledge Base a Identify una instancia Anteriores de una aplicación” (KB106385) en https://support.microsoft.com/default.aspx?scid=kb;es-es;106385.