Classe de CWinApp

Artigo
06/10/2015

A classe base que você deriva de um objeto de aplicativo do Windows.

class CWinApp : public CWinThread

Membros

Construtores public

Nome	Descrição
CWinApp::CWinApp	Constrói um objeto de CWinApp .

Métodos públicos

Nome	Descrição
CWinApp::AddDocTemplate	Adiciona um modelo de documento de aplicativo à lista de modelos disponíveis do documento.
CWinApp::AddToRecentFileList	Adiciona um nome de arquivo para a lista recentemente usada do arquivo de (MRU).
CWinApp::ApplicationRecoveryCallback	Chamado pela estrutura quando o aplicativo sair inesperado.
CWinApp::CloseAllDocuments	Fecha todos os documentos abertos.
CWinApp::CreatePrinterDC	Cria um contexto de dispositivos de impressão.
CWinApp::DelRegTree	Excluir uma chave especificada e todas as suas subchaves.
CWinApp::DoMessageBox	Implementa AfxMessageBox para o aplicativo.
CWinApp::DoWaitCursor	Desliga o cursor de espera em e.
CWinApp::EnableD2DSupport	Permite que o suporte de D2D do aplicativo. Chamar este método antes que a janela principal é inicializada.
CWinApp::EnableHtmlHelp	Implementa HTMLHelp para o aplicativo, em vez de WinHelp.
CWinApp::EnableTaskbarInteraction	Permite que a interação da barra de tarefas.
CWinApp::ExitInstance	Substituição a limpeza quando o aplicativo finaliza.
CWinApp::GetApplicationRecoveryParameter	Recupera o parâmetro de entrada para o método de recuperação do aplicativo.
CWinApp::GetApplicationRecoveryPingInterval	Retorna o intervalo de tempo que o gerenciador de reinicialização espera a função de retorno de chamada de recuperação para retornar.
CWinApp::GetApplicationRestartFlags	Retorna os sinalizadores para o gerenciador de configuração.
CWinApp::GetAppRegistryKey	Retorna chave para HKEY_CURRENT_USER\"Software"\RegistryKey\ProfileName.
CWinApp::GetDataRecoveryHandler	Obtém o manipulador de recuperação de dados para essa instância do aplicativo.
CWinApp::GetFirstDocTemplatePosition	Retorna a posição do primeiro modelo do documento.
CWinApp::GetHelpMode	Recupera o tipo da ajuda usado pelo aplicativo.
CWinApp::GetNextDocTemplate	Retorna a posição de um modelo do documento. Pode ser usado recursivamente.
CWinApp::GetPrinterDeviceDefaults	Recupera as opções de dispositivos de impressão.
CWinApp::GetProfileBinary	Recupera dados binários de uma entrada no arquivo .ini do aplicativo.
CWinApp::GetProfileInt	Retorna um inteiro de uma entrada no arquivo .ini do aplicativo.
CWinApp::GetProfileString	Recupera uma cadeia de caracteres de uma entrada no arquivo .ini do aplicativo.
CWinApp::GetSectionKey	Retorna chave para HKEY_CURRENT_USER\"Software"\RegistryKey\AppName\lpszSection.
CWinApp::HideApplication	Oculta o aplicativo antes de fechar todos os documentos.
CWinApp::HtmlHelp	Chama a função do windows de HTMLHelp .
CWinApp::InitInstance	Substituição para executar o windows ativa a inicialização, como a criação de seus objetos da janela.
CWinApp::IsTaskbarInteractionEnabled	Informa se a interação da barra de tarefas do Windows 7 está habilitada.
CWinApp::LoadCursor	Carrega um recurso do cursor.
CWinApp::LoadIcon	Carrega um ícone de recursos.
CWinApp::LoadOEMCursor	Carrega um cursor predefinido OEM do windows que as constantes de OCR_ especifiquem em. WINDOWS.H.
CWinApp::LoadOEMIcon	Carrega um ícone predefinido OEM do windows que as constantes de OIC_ especifiquem em. WINDOWS.H.
CWinApp::LoadStandardCursor	Carrega um cursor predefinido o windows que as constantes de IDC_ especifiquem em. WINDOWS.H.
CWinApp::LoadStandardIcon	Carrega um ícone predefinido o windows que as constantes de IDI_ especifiquem em. WINDOWS.H.
CWinApp::OnDDECommand	Chamado pela estrutura em resposta a um equilíbrio dinâmicas de dados (DDE) executar o comando.
CWinApp::OnIdle	Substituição para executar o processamento específicas do aplicativo de tempo ocioso.
CWinApp::OpenDocumentFile	Chamado pela estrutura para abrir um documento de um arquivo.
CWinApp::ParseCommandLine	Analisa parâmetros individuais e sinalizadores na linha de comando.
CWinApp::PreTranslateMessage	Mensagens de filtro antes que elas sejam despachados funções do windows TranslateMessage e DispatchMessage.
CWinApp::ProcessMessageFilter	Determinadas mensagens de intercepções antes que atingiu o aplicativo.
CWinApp::ProcessShellCommand	Argumentos de linha de comando e sinalizadores handles.
CWinApp::ProcessWndProcException	Intercepta todas as exceções não tratadas geradas por manipuladores de mensagem e de comando do aplicativo.
CWinApp::Register	Performs personalizou o registro.
CWinApp::RegisterWithRestartManager	Registra o aplicativo com o gerenciador de configuração.
CWinApp::ReopenPreviousFilesAtRestart	Determina se o gerenciador de reinicialização reabre os arquivos que foram abertos quando o aplicativo foi encerrado inesperado.
CWinApp::RestartInstance	Trata a reinicialização do aplicativo iniciado pelo gerenciador de configuração.
CWinApp::RestoreAutosavedFilesAtRestart	Determina se o gerenciador de reinicialização restaurar os arquivos autosaved quando reiniciar o aplicativo.
CWinApp::Run	Executa o loop de mensagem padrão. Substituição para personalizar o loop de mensagens.
CWinApp::RunAutomated	Testa a linha de comando do aplicativo para a opção de /Automation . Obsoleto. Em vez de isso, use o valor em CCommandLineInfo::m_bRunAutomated após chamar ParseCommandLine.
CWinApp::RunEmbedded	Testa a linha de comando do aplicativo para a opção de /Embedding . Obsoleto. Em vez de isso, use o valor em CCommandLineInfo::m_bRunEmbedded após chamar ParseCommandLine.
CWinApp::SaveAllModified	Solicita ao usuário para salvar todos os documentos alterados.
CWinApp::SelectPrinter	Seleciona uma impressora indicada anteriormente pelo usuário através de uma caixa de diálogo.
CWinApp::SetHelpMode	Os conjuntos e inicializam o tipo da ajuda usado pelo aplicativo.
CWinApp::SupportsApplicationRecovery	Determina se o gerenciador de reinicialização recupera um aplicativo de sair inesperado.
CWinApp::SupportsAutosaveAtInterval	Determina se o gerenciador de reinicialização autosaves documentos abertos em um intervalo normal.
CWinApp::SupportsAutosaveAtRestart	Determina se o gerenciador de reinicialização autosaves os documentos abertos quando o aplicativo for reiniciado.
CWinApp::SupportsRestartManager	Determina se o aplicativo suporta o gerenciador de configuração.
CWinApp::Unregister	Desregistre todos conhecidos para ser registrado pelo objeto de CWinApp .
CWinApp::WinHelp	Chama a função do windows de WinHelp .
CWinApp::WriteProfileBinary	Grava dados binários a uma entrada no arquivo .ini do aplicativo.
CWinApp::WriteProfileInt	Grava um inteiro para uma entrada no arquivo .ini do aplicativo.
CWinApp::WriteProfileString	Grava uma cadeia de caracteres a uma entrada no arquivo .ini do aplicativo.

Métodos protegidos

Nome	Descrição
CWinApp::EnableShellOpen	Permite que o usuário abre arquivos de dados do gerenciador de arquivos do windows.
CWinApp::LoadStdProfileSettings	Carrega configurações padrão do arquivo .ini e permite que o recurso de lista do arquivo de MRU.
CWinApp::OnContextHelp	Ajuda handles SHIFT+F1 dentro do aplicativo.
CWinApp::OnFileNew	Implementa o comando de ID_FILE_NEW .
CWinApp::OnFileOpen	Implementa o comando de ID_FILE_OPEN .
CWinApp::OnFilePrintSetup	Implementa o comando de ID_FILE_PRINT_SETUP .
CWinApp::OnHelp	F1 ajuda handles dentro do aplicativo (que usa o contexto atual.)
CWinApp::OnHelpFinder	Trata os comandos de ID_HELP_FINDER e de ID_DEFAULT_HELP .
CWinApp::OnHelpIndex	Trata o comando de ID_HELP_INDEX e fornece um tópico da Ajuda padrão.
CWinApp::OnHelpUsing	Trata o comando de ID_HELP_USING .
CWinApp::RegisterShellFileTypes	Registrar os tipos de documento de qualquer aplicativo com o gerenciador de arquivos do windows.
CWinApp::SetAppID	Define explicitamente a identificação do modelo de usuário do aplicativo para o aplicativo. Esse método deve ser chamado antes que qualquer interface de usuário seja projetada para o usuário (melhor local é o construtor do aplicativo).
CWinApp::SetRegistryKey	Faz com que as configurações do aplicativo sejam armazenadas no Registro em vez dos arquivos de .INI.
CWinApp::UnregisterShellFileTypes	Desregistre os tipos de documento de qualquer aplicativo com o gerenciador de arquivos do windows.

Membros públicos de dados

Nome	Descrição
CWinApp::m_bHelpMode	Indica se o usuário está no modo de contexto da ajuda (normalmente chamado com SHIFT+F1).
CWinApp::m_eHelpType	Especifica o tipo da ajuda usado pelo aplicativo.
CWinApp::m_hInstance	Identifica a instância atual do aplicativo.
CWinApp::m_lpCmdLine	Aponta para uma cadeia de caracteres NULL- finalizada que especifica a linha de comando para o aplicativo.
CWinApp::m_nCmdShow	Especifica como a janela deve ser mostrada inicialmente.
CWinApp::m_pActiveWnd	Ponteiro para a janela principal do aplicativo quando um contêiner de servidor OLE está no lugar.
CWinApp::m_pszAppID	Identificação do modelo de usuário do aplicativo
CWinApp::m_pszAppName	Especifica o nome do aplicativo.
CWinApp::m_pszExeName	O nome do módulo do aplicativo.
CWinApp::m_pszHelpFilePath	O caminho para o arquivo de ajuda do aplicativo.
CWinApp::m_pszProfileName	O nome de arquivo de .INI do aplicativo.
CWinApp::m_pszRegistryKey	Usado para determinar a chave do Registro completa para armazenar configurações de perfil do aplicativo.

Membros de dados protegidos

Nome	Descrição
CWinApp::m_dwRestartManagerSupportFlags	Sinalizadores que determinam como o gerenciador de reinicialização se comporta.
CWinApp::m_nAutosaveInterval	O período de tempo em milissegundos entre autosaves.
CWinApp::m_pDataRecoveryHandler	Ponteiro para o manipulador de recuperação de dados para o aplicativo.

Comentários

Um objeto application fornece funções de membro para inicializar seu aplicativo (e cada instância de ele) e executar o aplicativo.

Cada aplicativo que usa as classes de base da Microsoft pode conter somente um objeto derivado de CWinApp. Este objeto é construído quando outros objetos globais C++ são construídos e já está disponível quando o chama a função de WinMain , que é fornecida pela biblioteca de classes da Microsoft foundation. Declare o objeto derivado de CWinApp no nível global.

Quando você derivado de uma classe de aplicativo de CWinApp, substitua a função de membro de InitInstance para criar o objeto da janela principal do seu aplicativo.

Além das funções de membro de CWinApp , a biblioteca de classes de base do Microsoft fornece as seguintes funções globais para acessar o objeto de CWinApp e outras informações globais:

AfxGetApp obtém um ponteiro para o objeto de CWinApp .
AfxGetInstanceHandle obtém um identificador para a instância do aplicativo atual.
AfxGetResourceHandle obtém um identificador para recursos do aplicativo.
AfxGetAppName obtém um ponteiro para uma cadeia de caracteres que contém o nome do aplicativo. Como alternativa, se você tiver um ponteiro para o objeto de CWinApp , use m_pszExeName para obter o nome do aplicativo.

Consulte para obter mais CWinApp: A classe do aplicativo na classe de CWinApp , incluindo uma visão geral do seguinte:

CWinApp- derivado código escrito pelo assistente do aplicativo.
A função de CWinApp na seqüência de execução do seu aplicativo.
Implementações padrão da função de membro de CWinApp.
Os substituíveis chave de CWinApp.

O membro de dados de m_hPrevInstance ainda não existir. Para obter informações sobre como detectar uma instância anterior de CWinApp, consulte o artigo de Base de Dados de Conhecimento “como identificar uma instância anterior de um aplicativo KB106385 (”) em https://support.microsoft.com/default.aspx?scid=kb;en-us;106385.