Compartilhar via


Classe de CWinApp

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

class CWinApp : public CWinThread

Membros

362kaah4.collapse_all(pt-br,VS.110).gifConstrutores public

Nome

Descrição

CWinApp::CWinApp

Constrói um objeto de CWinApp .

362kaah4.collapse_all(pt-br,VS.110).gifMé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.

362kaah4.collapse_all(pt-br,VS.110).gifMé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.

362kaah4.collapse_all(pt-br,VS.110).gifMembros 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.

362kaah4.collapse_all(pt-br,VS.110).gifMembros 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.

Hierarquia de herança

CObject

CCmdTarget

CWinThread

CWinApp

Requisitos

Cabeçalho: afxwin.h

Consulte também

Tarefas

Como: adicionar o suporte do Gerenciador de reinicialização

Referência

Classe de CWinThread

Gráfico de hierarquia