Partilhar via

CWinAppEx classe

  • Artigo

CWinAppEx manipula o estado do aplicativo, salva o estado no registro, carrega o estado do registro, inicializa gerenciadores de aplicativos e fornece links para esses mesmos gerenciadores de aplicativos.

Para obter mais detalhes, consulte o código-fonte localizado na pasta mfc da instalação do Visual Studio. Por exemplo, %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Sintaxe

class CWinAppEx : public CWinApp

Membros

Construtores Públicos

Designação Descrição
CWinAppEx::CWinAppEx Constrói um objeto CWinAppEx.

Métodos Públicos

Designação Descrição
CWinAppEx::CleanState Remove informações sobre o aplicativo do registro do Windows.
CWinAppEx::EnableLoadWindowPlacement Especifica se o aplicativo carregará o tamanho inicial e o local da janela do quadro principal do Registro.
CWinAppEx::EnableTearOffMenus Permite menus destacáveis para o aplicativo.
CWinAppEx::EnableUserTools Permite que o usuário crie comandos de menu personalizados no aplicativo.
CWinAppEx::ExitInstance Chamado pela estrutura de dentro da função de membro Run para sair desta instância do aplicativo. (Substitui CWinApp::ExitInstance.)
CWinAppEx::GetBinary Lê dados binários associados ao valor do Registro especificado.
CWinAppEx::GetContextMenuManager Retorna um ponteiro para o objeto CContextMenuManager global.
CWinAppEx::GetDataVersion
CWinAppEx::GetDataVersionMajor Retorna a versão principal do aplicativo salvo no registro do Windows.
CWinAppEx::GetDataVersionMinor Retorna a versão secundária do aplicativo salvo no registro do Windows.
CWinAppEx::GetInt Lê dados numéricos associados ao valor especificado do Registro.
CWinAppEx::GetKeyboardManager Retorna um ponteiro para o objeto CKeyboardManager global.
CWinAppEx::GetMouseManager Retorna um ponteiro para o objeto CMouseManager global.
CWinAppEx::GetObject Lê CObjectdados derivados associados ao valor especificado do Registro.
CWinAppEx::GetRegSectionPath Retorna uma cadeia de caracteres que é o caminho de uma chave do Registro. Esse caminho concatena o caminho relativo fornecido com o caminho do aplicativo.
CWinAppEx::GetRegistryBase Retorna o caminho do Registro para o aplicativo.
CWinAppEx::GetSectionBinary Lê dados binários associados à chave e ao valor especificados do Registro.
CWinAppEx::GetSectionInt Lê dados numéricos do registro associados à chave e ao valor especificados.
CWinAppEx::GetSectionObject Lê CObject dados associados à chave e ao valor especificados do Registro.
CWinAppEx::GetSectionString Lê os dados da cadeia de caracteres associados à chave e ao valor especificados do Registro.
CWinAppEx::GetShellManager Retorna um ponteiro para o objeto CShellManager global.
CWinAppEx::GetString Lê dados de cadeia de caracteres associados ao valor especificado do Registro.
CWinAppEx::GetTooltipManager Retorna um ponteiro para o objeto CTooltipManager global.
CWinAppEx::GetUserToolsManager Retorna um ponteiro para o objeto CUserToolsManager global.
CWinAppEx::InitContextMenuManager Inicializa o objeto CContextMenuManager.
CWinAppEx::InitKeyboardManager Inicializa o objeto CKeyboardManager.
CWinAppEx::InitMouseManager Inicializa o objeto CMouseManager.
CWinAppEx::InitShellManager Inicializa a classe CShellManager
CWinAppEx::InitTooltipManager Inicializa a classe CTooltipManager.
CWinAppEx::IsResourceSmartUpdate
CWinAppEx::IsStateExists Indica se a chave especificada está no Registro.
CWinAppEx::LoadState Carrega o estado do aplicativo do Registro.
CWinAppEx::OnAppContextHelp Chamado pela estrutura quando o usuário solicita ajuda de contexto para a caixa de diálogo Personalização.
CWinAppEx::OnViewDoubleClick Chama o comando definido pelo usuário quando o usuário clica duas vezes em qualquer lugar do aplicativo.
CWinAppEx::OnWorkspaceIdle
CWinAppEx::SaveState Grava o estado da estrutura do aplicativo no registro do Windows.
CWinAppEx::SetRegistryBase Define o caminho da chave do Registro padrão. Essa chave servirá como uma raiz para todas as chamadas de registro subsequentes.
CWinAppEx::ShowPopupMenu Exibe um menu pop-up.
CWinAppEx::WriteBinary Grava os dados binários no valor do Registro especificado.
CWinAppEx::WriteInt Grava os dados numéricos no valor do Registro especificado.
CWinAppEx::WriteObject Grava dados derivados da classe CObject no valor do Registro especificado.
CWinAppEx::WriteSectionBinary Grava os dados binários em um valor da chave do Registro especificada.
CWinAppEx::WriteSectionInt Grava os dados numéricos em um valor da chave do Registro especificada.
CWinAppEx::WriteSectionObject Grava dados derivados da classe CObject em um valor da chave do Registro especificada.
CWinAppEx::WriteSectionString Grava os dados da cadeia de caracteres em um valor da chave do Registro especificada.
CWinAppEx::WriteString Grava os dados da cadeia de caracteres no valor do Registro especificado.

Métodos Protegidos

Designação Descrição
CWinAppEx::LoadCustomState Chamado pela estrutura quando o estado do aplicativo foi carregado.
CWinAppEx::LoadWindowPlacement Chamado pela estrutura quando ele carrega o tamanho e o local do seu aplicativo do registro. Os dados carregados incluem o tamanho e a localização do quadro principal no momento em que o aplicativo foi fechado pela última vez.
CWinAppEx::OnClosingMainFrame Chamado pela estrutura quando uma janela de quadro principal está processando WM_CLOSE.
CWinAppEx::PreLoadState Chamado pela estrutura imediatamente antes do estado do aplicativo ser carregado.
CWinAppEx::PreSaveState Chamado pela estrutura imediatamente antes do estado do aplicativo ser salvo.
CWinAppEx::ReloadWindowPlacement Recarrega o tamanho e a localização da janela fornecida a partir do registo
CWinAppEx::SaveCustomState Chamado pela estrutura depois que ele grava o estado do aplicativo no registro.
CWinAppEx::StoreWindowPlacement Chamado pela estrutura para gravar o tamanho e a localização do quadro principal no registro.

Membros de dados

Designação Descrição
CWinAppEx::m_bForceImageReset Especifica se a estrutura redefinirá todas as imagens da barra de ferramentas quando a janela de quadro que contém a barra de ferramentas for carregada.

Comentários

Grande parte da funcionalidade fornecida pela estrutura MFC depende da classe CWinAppEx. Você pode incorporar a classe CWinAppEx em seu aplicativo de duas maneiras:

  • Construa uma classe CWinAppEx no thread principal.

  • Derive a classe de aplicativo principal de CWinAppEx.

Depois de incorporar CWinAppEx em seu aplicativo, você pode inicializar qualquer um dos gerenciadores de aplicativos. Antes de usar um gerenciador de aplicativos, você deve inicializá-lo chamando o método de inicialização apropriado. Para obter um ponteiro para um gerente específico, chame o método get associado. A classe CWinAppEx gerencia os seguintes gerenciadores de aplicativos: CMouseManager Class, CContextMenuManager Class, CKeyboardManager Class, CUserToolsManager Classe CMenuTearOffManager Class.

Hierarquia de herança

CObject

CCmdTarget

CWinThread

CWinApp

CWinAppEx

Requerimentos

Cabeçalho:afxwinappex.h

CWinAppEx::CleanState

Remove todas as informações sobre o aplicativo do registro do Windows.

virtual BOOL CleanState(LPCTSTR lpszSectionName=NULL);

Parâmetros

lpszSectionName
[em] Uma cadeia de caracteres que contém um caminho de uma chave do Registro.

Valor de retorno

Diferente de zero se o método foi bem-sucedido; caso contrário, 0.

Comentários

Esse método limpa os dados do aplicativo de uma seção específica do registro. Você pode especificar a seção a ser limpa usando o parâmetro lpszSectionName. Se lpszSectionName estiver NULL, esse método usará o caminho do Registro padrão armazenado no objeto CWinAppEx. Para obter o caminho do Registro padrão, use CWinAppEx::GetRegistryBase.

CWinAppEx::CWinAppEx

Constrói um objeto CWinAppEx.

CWinAppEx(BOOL bResourceSmartUpdate = FALSE);

Parâmetros

bResourceSmartUpdate
[em] Um parâmetro booleano que especifica se o objeto de espaço de trabalho deve detetar e manipular atualizações de recursos.

Comentários

A classe CWinAppEx tem métodos de inicialização, fornece funcionalidade para salvar e carregar informações do aplicativo no Registro e controla as configurações globais do aplicativo. Ele também permite que você use gerentes globais, como o CKeyboardManager Class e o CUserToolsManager Class. Cada aplicativo pode ter apenas uma instância da classe CWinAppEx.

CWinAppEx::EnableLoadWindowPlacement

Especifica se o aplicativo carregará o tamanho inicial e o local da janela do quadro principal do Registro.

void EnableLoadWindowPlacement(BOOL bEnable = TRUE);

Parâmetros

bEnable
[em] Especifica se o aplicativo carrega o tamanho inicial e o local da janela do quadro principal do Registro.

Comentários

Por padrão, o tamanho e o local do quadro principal são carregados do registro juntamente com outras configurações do aplicativo. Isso ocorre durante CWinAppEx::LoadState. Se você não quiser carregar o posicionamento inicial da janela do Registro, chame esse método com bEnable definido como FALSE.

CWinAppEx::EnableTearOffMenus

Cria e inicializa um objeto CMenuTearOffManager.

BOOL EnableTearOffMenus(
    LPCTSTR lpszRegEntry,
    const UINT uiCmdFirst,
    const UINT uiCmdLast);

Parâmetros

lpszRegEntry
[em] Uma cadeia de caracteres que contém o caminho de uma chave do Registro. O aplicativo usa essa chave do Registro para armazenar informações para os menus destacáveis.

uiCmdFirst
[em] O primeiro ID do menu de desmontagem.

uiCmdLast
[em] O último ID do menu de rasgão.

Valor de retorno

TRUE se o CMenuTearOffManager foi criado e inicializado com êxito; FALSE se ocorrer um erro ou se o CMenuTearOffManager já existir.

Comentários

Use esta função para ativar menus destacáveis em seu aplicativo. Você deve chamar essa função de InitInstance.

CWinAppEx::EnableUserTools

Permite que o usuário crie comandos de menu personalizados que reduzem as teclas pressionadas em seu aplicativo. Esse método cria um objeto CUserToolsManager.

BOOL EnableUserTools(
    const UINT uiCmdToolsDummy,
    const UINT uiCmdFirst,
    const UINT uiCmdLast,
    CRuntimeClass* pToolRTC = RUNTIME_CLASS(CUserTool),
    UINT uArgMenuID = 0,
    UINT uInitDirMenuID = 0);

Parâmetros

uiCmdToolsDummy
[em] Um inteiro não assinado que a estrutura usa como um espaço reservado para a ID de comando do menu de ferramentas do usuário.

uiCmdFirst
[em] O ID do comando para o primeiro comando da ferramenta do usuário.

uiCmdLast
[em] A ID do comando para o último comando da ferramenta do usuário.

pToolRTC
[em] Uma classe que o objeto CUserToolsManager usa para criar novas ferramentas de usuário.

uArgMenuID
[em] O ID do menu de argumento.

uInitDirMenuID
[em] O ID de menu para o diretório inicial da ferramenta.

Valor de retorno

TRUE se o método cria e inicializa um objeto CUserToolsManager; FALSE se o método falhar ou se já existir um objeto CUserToolsManager.

Comentários

Quando você habilita ferramentas definidas pelo usuário, a estrutura suporta automaticamente um menu dinâmico que pode ser estendido durante a personalização. A estrutura associa cada novo item a um comando externo. A estrutura invoca esses comandos quando o usuário seleciona o item apropriado no menu Ferramentas.

Toda vez que o usuário adiciona um novo item, a estrutura cria um novo objeto. O tipo de classe para o novo objeto é definido por pToolRTC. O tipo de classe pToolRTC deve ser derivado do CUserTool Class.

Para obter mais informações sobre ferramentas de usuário e como incorporá-las em seu aplicativo, consulte Ferramentas definidas pelo usuário.

CWinAppEx::ExitInstance

virtual int ExitInstance();

Valor de retorno

Comentários

CWinAppEx::GetBinary

Lê dados binários de uma chave do Registro especificada.

BOOL GetBinary(
    LPCTSTR lpszEntry,
    LPBYTE* ppData,
    UINT* pBytes);

Parâmetros

lpszEntry
[em] Uma cadeia de caracteres que contém o nome de uma chave do Registro.

ppData
[saídas] Um ponteiro para o buffer que o método preenche com os dados binários.

pBytes
[saídas] Um ponteiro para um inteiro não assinado que o método usa para gravar o número de bytes lidos.

Valor de retorno

TRUE se for bem-sucedida; FALSE o contrário.

Comentários

Este método lê dados binários gravados no registro. Para gravar dados no registro, use os métodos CWinAppEx::WriteBinary e CWinAppEx::WriteSectionBinary.

O parâmetro lpszEntry é o nome de uma entrada do Registro localizada sob a chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

CWinAppEx::GetContextMenuManager

Retorna um ponteiro para o objeto CContextMenuManager global.

CContextMenuManager* GetContextMenuManager();

Valor de retorno

Um ponteiro para o objeto CContextMenuManager global.

Comentários

Se o objeto CContextMenuManager não for inicializado, essa função chamará CWinAppEx::InitContextMenuManager antes de retornar um ponteiro.

CWinAppEx::GetDataVersion

int GetDataVersion() const;

Valor de retorno

Comentários

CWinAppEx::GetDataVersionMajor

Retorna a versão principal do aplicativo que é salvo no registro do Windows quando você chama CWinAppEx::SaveState.

int GetDataVersionMajor() const;

Valor de retorno

Um valor inteiro que contém o número da versão principal.

CWinAppEx::GetDataVersionMinor

Retorna a versão secundária do aplicativo que é salvo no registro do Windows quando você chama CWinAppEx::SaveState.

int GetDataVersionMinor() const;

Valor de retorno

Um valor inteiro que contém o número da versão secundária.

CWinAppEx::GetInt

Lê dados inteiros de uma chave do Registro especificada.

int GetInt(
    LPCTSTR lpszEntry,
    int nDefault = 0);

Parâmetros

lpszEntry
[em] Uma cadeia de caracteres que contém o nome de uma entrada do Registro.

nDefault
[em] O valor padrão que o método retorna se a entrada do Registro especificada não existir.

Valor de retorno

Os dados do Registro se o método foi bem-sucedido; caso contrário, nDefault.

Comentários

Esse método lê dados inteiros do registro. Se não houver dados inteiros associados à chave do Registro indicada por lpszEntry, esse método retornará nDefault. Para gravar dados no registro, use os métodos CWinAppEx::WriteSectionInt e CWinAppEx::WriteInt.

O parâmetro lpszEntry é o nome de uma entrada do Registro localizada sob a chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

CWinAppEx::GetKeyboardManager

Retorna um ponteiro para o objeto CKeyboardManager global.

CKeyboardManager* GetKeyboardManager();

Valor de retorno

Um ponteiro para o objeto CKeyboardManager global.

Comentários

Se o gerenciador de teclado não for inicializado, essa função chamará CWinAppEx::InitKeyboardManager antes de retornar um ponteiro.

CWinAppEx::GetMouseManager

Retorna um ponteiro para o objeto CMouseManager global.

CMouseManager* GetMouseManager();

Valor de retorno

Um ponteiro para o objeto CMouseManager global.

Comentários

Se o gerenciador de mouse não for inicializado, essa função chamará CWinAppEx::InitMouseManager antes de retornar um ponteiro.

CWinAppEx::GetObject

Lê CObjectdados -dervied do registro.

BOOL GetObject(
    LPCTSTR lpszEntry,
    CObject& obj);

Parâmetros

lpszEntry
[em] Uma cadeia de caracteres que contém o caminho relativo de uma entrada do Registro.

obj
[saídas] Uma referência a um CObject. O método usa essa referência para armazenar os dados do Registro.

Valor de retorno

Diferente de zero se o método foi bem-sucedido; caso contrário, 0.

Comentários

Este método lê dados do registo que é derivado de CObject. Para gravar CObject dados no Registro, use CWinAppEx::WriteObject ou CWinAppEx::WriteSectionObject.

O parâmetro lpszEntry é o nome de uma entrada do Registro que está localizada sob a chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

CWinAppEx::GetRegistryBase

Recupera o caminho do Registro padrão para o aplicativo.

LPCTSTR GetRegistryBase();

Valor de retorno

Uma cadeia de caracteres que contém o caminho do local do Registro padrão.

Comentários

Todos os métodos do CWinAppEx Class que acessam o registro começam em um local padrão. Use esse método para recuperar um caminho do local do Registro padrão. Use CWinAppEx::SetRegistryBase para alterar o local do Registro padrão.

CWinAppEx::GetRegSectionPath

Cria e retorna o caminho absoluto de uma chave do Registro.

CString GetRegSectionPath(LPCTSTR szSectionAdd = _T(""));

Parâmetros

szSectionAdd
[em] Uma cadeia de caracteres que contém o caminho relativo de uma chave do Registro.

Valor de retorno

Um CString que contém o caminho absoluto de uma chave do Registro.

Comentários

Esse método define o caminho absoluto da chave do Registro anexando o caminho relativo em szSectionAdd ao local do Registro padrão para seu aplicativo. Para obter a chave de registo predefinida, utilize o método CWinAppEx::GetRegistryBase.

CWinAppEx::GetSectionBinary

Lê dados binários do Registro.

BOOL GetSectionBinary(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    LPBYTE* ppData,
    UINT* pBytes);

Parâmetros

lpszSubSection
[em] Uma cadeia de caracteres que contém o caminho relativo de uma chave do Registro.

lpszEntry
[em] Uma cadeia de caracteres que contém o valor a ser lido.

ppData
[saídas] Um ponteiro para o buffer onde o método armazena os dados.

pBytes
[saídas] Um ponteiro para um inteiro não assinado. O método grava o tamanho do ppData para esse parâmetro.

Valor de retorno

TRUE se for bem-sucedida; caso contrário, FALSE.

Comentários

Esse método lê dados binários que são gravados no registro usando os métodos CWinAppEx::WriteBinary e CWinAppEx::WriteSectionBinary.

O parâmetro lpszSubSection não é um caminho absoluto para uma entrada do Registro. É um caminho relativo que é anexado ao final da chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

CWinAppEx::GetSectionInt

Lê dados inteiros do Registro.

int GetSectionInt(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    int nDefault = 0);

Parâmetros

lpszSubSection
[em] Uma cadeia de caracteres que contém o caminho relativo de uma chave do Registro.

lpszEntry
[em] Uma cadeia de caracteres que contém o valor a ser lido.

nDefault
[em] O valor padrão a ser retornado se o valor especificado não existir.

Valor de retorno

Os dados inteiros armazenados no valor do Registro especificado; nDefault se os dados não existirem.

Comentários

Use os métodos CWinAppEx::WriteInt e CWinAppEx::WriteSectionInt para gravar dados inteiros no registro.

O parâmetro lpszSubSection não é um caminho absoluto de uma entrada do Registro. É um caminho relativo que é adicionado ao final da chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

CWinAppEx::GetSectionObject

Lê CObject dados do registo a partir do registo.

BOOL GetSectionObject(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    CObject& obj);

Parâmetros

lpszSubSection
[em] Uma cadeia de caracteres que contém o caminho relativo de uma chave do Registro.

lpszEntry
[em] Uma cadeia de caracteres que contém o valor a ser lido.

obj
[saídas] Uma referência a um CObject. O método usa esse CObject para armazenar os dados do Registro.

Valor de retorno

Diferente de zero se for bem-sucedido; caso contrário, 0.

Comentários

Este método lê dados do registo. Os dados lidos são dados CObject ou dados de uma classe derivada de CObject. Para gravar CObject dados no Registro, use CWinAppEx::WriteObject ou CWinAppEx::WriteSectionObject.

O parâmetro lpszSubSection não é um caminho absoluto para uma entrada do Registro. É um caminho relativo que é anexado ao final da chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

CWinAppEx::GetSectionString

Lê dados de cadeia de caracteres do Registro.

CString GetSectionString(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    LPCTSTR lpszDefault = _T(""));

Parâmetros

lpszSubSection
[em] Uma cadeia de caracteres que contém o caminho relativo de uma chave do Registro.

lpszEntry
[em] Uma cadeia de caracteres que contém o valor a ser lido.

lpszDefault
[em] O valor padrão a ser retornado se o valor especificado não existir.

Valor de retorno

Os dados de cadeia de caracteres armazenados no valor do Registro especificado, se os dados existirem; caso contrário, lpszDefault.

Comentários

Esse método lê dados de cadeia de caracteres gravados no registro. Use CWinAppEx::WriteString e CWinAppEx::WriteSectionString para gravar dados de cadeia de caracteres no registro.

O parâmetro lpszSubSection não é um caminho absoluto para uma entrada do Registro. É um caminho relativo que é anexado ao final da chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

CWinAppEx::GetShellManager

Retorna um ponteiro para o objeto CShellManager global.

CShellManager* GetShellManager();

Valor de retorno

Um ponteiro para o objeto CShellManager global.

Comentários

Se o objeto CShellManager não for inicializado, essa função chamará CWinAppEx::InitShellManager antes de retornar um ponteiro.

CWinAppEx::GetString

Lê dados de cadeia de caracteres de uma chave do Registro especificada.

CString GetString(
    LPCTSTR lpszEntry,
    LPCTSTR lpzDefault= _T(""));

Parâmetros

lpszEntry
[em] Uma cadeia de caracteres que contém o nome de uma chave do Registro

lpzDefault
[em] O valor padrão que o método retorna se a entrada do Registro especificada não existir.

Valor de retorno

Os dados de cadeia de caracteres armazenados no registro, se bem-sucedidos; lpszDefault o contrário.

Comentários

Esse método lê dados de cadeia de caracteres gravados no registro. Para gravar dados no registro, use os métodos CWinAppEx::WriteString ou CWinAppEx::WriteSectionString.

O parâmetro lpszEntry é o nome de uma entrada do Registro localizada sob a chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

CWinAppEx::GetTooltipManager

Retorna um ponteiro para o objeto CTooltipManager global.

CTooltipManager* GetTooltipManager();

Valor de retorno

Um ponteiro para o objeto CTooltipManager global.

Comentários

Se o objeto CTooltipManager não for inicializado, essa função chamará CWinAppEx::InitTooltipManager antes de retornar um ponteiro.

CWinAppEx::GetUserToolsManager

Retorna um ponteiro para o objeto CUserToolsManager global.

CUserToolsManager* GetUserToolsManager();

Valor de retorno

Um ponteiro para o objeto CUserToolsManager global; NULL se o gerenciamento de ferramentas de usuário não estiver habilitado para o aplicativo.

Comentários

Antes de recuperar um ponteiro para o objeto CUserToolsManager, você deve inicializar o gerenciador chamando CWinAppEx::EnableUserTools.

CWinAppEx::InitContextMenuManager

Inicializa o objeto CContextMenuManager.

BOOL InitContextMenuManager();

Valor de retorno

Diferente de zero se o método cria o objeto CContextMenuManager; 0 se o objeto CContextMenuManager já existir.

Comentários

Se você chamar CWinAppEx::GetContextMenuManager, a implementação padrão desse método chamará InitContextMenuManager.

Se seu aplicativo já tiver um gerenciador de menu de contexto e você chamar InitContextMenuManager, seu aplicativo terá uma falha ASSERT. Portanto, você não deve chamar InitContextMenuManager se criar um objeto CContextMenuManager diretamente. Se você não estiver usando um CContextMenuManagerpersonalizado, deverá usáGetContextMenuManager para criar um objeto CContextMenuManager.

CWinAppEx::InitKeyboardManager

Inicializa o objeto CKeyboardManager.

BOOL InitKeyboardManager();

Valor de retorno

Diferente de zero se o método cria o objeto CKeyboardManager; 0 se o objeto CKeyboardManager já existir.

Comentários

Se você chamar CWinAppEx::GetKeyboardManager, a implementação padrão desse método chamará InitKeyboardManager.

Se o seu aplicativo já tiver um gerenciador de teclado e você chamar InitKeyboardManager, seu aplicativo terá uma falha ASSERT. Portanto, você não deve chamar InitKeyboardManager se criar um objeto CKeyboardManager diretamente. Se você não estiver usando um CKeyboardManagerpersonalizado, deverá usáGetKeyboardManager para criar um objeto CKeyboardManager.

CWinAppEx::InitMouseManager

Inicializa o objeto CMouseManager.

BOOL InitMouseManager();

Valor de retorno

Diferente de zero se o método cria o objeto CMouseManager; 0 se o objeto CMouseManager já existir.

Comentários

Se você chamar CWinAppEx::GetMouseManager, a implementação padrão desse método chamará InitMouseManager.

Se o seu aplicativo já tiver um gerenciador de mouse e você chamar InitMouseManager, seu aplicativo terá uma falha ASSERT. Portanto, você não deve chamar InitMouseManager se criar um objeto CMouseManager diretamente. Se você não estiver usando um CMouseManagerpersonalizado, deverá usáGetMouseManager para criar um objeto CMouseManager.

CWinAppEx::InitShellManager

Inicializa o objeto CShellManager.

BOOL InitShellManager();

Valor de retorno

Diferente de zero se o método cria o objeto CShellManager; 0 se o objeto CShellManager já existir.

Comentários

Se você chamar CWinAppEx::GetShellManager, a implementação padrão desse método chamará InitShellManager.

Se seu aplicativo já tiver um gerenciador de shell e você chamar InitShellManager, seu aplicativo gerará uma falha ASSERT. Portanto, não chame InitShellManager se você criar um objeto CShellManager diretamente. Se você não estiver usando um CShellManagerpersonalizado, use GetShellManager para criar um objeto CShellManager.

CWinAppEx::InitTooltipManager

Inicializa o objeto CTooltipManager.

BOOL InitTooltipManager();

Valor de retorno

Diferente de zero se o método cria o objeto CTooltipManager; 0 se o objeto CTooltipManager já existir.

Comentários

Se você chamar CWinAppEx::GetTooltipManager, a implementação padrão desse método chamará InitTooltipManager.

Se seu aplicativo já tiver um gerenciador de dicas de ferramentas e você chamar InitTooltipManager, seu aplicativo terá uma falha ASSERT. Portanto, você não deve chamar InitTooltipManager se criar um objeto CTooltipManager diretamente. Se você não estiver usando um CTooltipManagerpersonalizado, deverá usáGetTooltipManager para criar um objeto CTooltipManager.

CWinAppEx::IsResourceSmartUpdate

BOOL IsResourceSmartUpdate() const;

Valor de retorno

Comentários

CWinAppEx::IsStateExists

Indica se a chave especificada está no Registro.

BOOL IsStateExists(LPCTSTR lpszSectionName);

Parâmetros

lpszSectionName
[em] Uma cadeia de caracteres que contém um caminho de uma chave do Registro.

Valor de retorno

Diferente de zero se a chave estiver no registro; caso contrário, 0.

CWinAppEx::LoadCustomState

A estrutura chama esse método depois que ele carrega o estado do aplicativo do registro.

virtual void LoadCustomState();

Comentários

Substitua esse método se você quiser fazer qualquer processamento depois que o aplicativo carrega o estado do registro. Por padrão, esse método não faz nada.

Para carregar informações de estado personalizado do registro, as informações devem primeiro ser salvas usando CWinAppEx::SaveCustomState.

CWinAppEx::LoadState

Lê o estado do aplicativo a partir do registro do Windows.

BOOL LoadState(
    CMDIFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

BOOL LoadState(
    CFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

BOOL LoadState(
    COleIPFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

virtual BOOL LoadState(
    LPCTSTR lpszSectionName = NULL,
    CFrameImpl* pFrameImpl = NULL);

Parâmetros

pFrame
[em] Um ponteiro para um objeto de janela de quadro. O método aplica as informações de estado no registro para esta janela de quadro.

lpszSectionName
[em] Uma cadeia de caracteres que contém o caminho relativo de uma chave do Registro.

pFrameImpl
[em] Um ponteiro para um objeto CFrameImpl. O método aplica as informações de estado no registro para esta janela de quadro.

Valor de retorno

Diferente de zero se for bem-sucedido; 0 caso contrário.

Comentários

Esse método carrega o estado do aplicativo e todas as informações de estado para uma janela de quadro. As informações carregadas para a janela de quadro são aplicadas à janela de quadro fornecida. Se você não fornecer uma janela de quadro, somente as informações de estado do aplicativo serão carregadas. As informações do aplicativo incluem o estado do CMouseManager Classe, CContextMenuManager Classe, CKeyboardManager Classee o CUserToolsManager Classe.

A implementação padrão de chamadas CFrameImpl::OnLoadFrameLoadState.

O parâmetro lpszSectionName não é o caminho absoluto para uma entrada do Registro. É um caminho relativo que é adicionado ao final da chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

CWinAppEx::LoadWindowPlacement

Chamado pela estrutura quando carrega o tamanho e a localização da janela do quadro principal do registro.

virtual BOOL LoadWindowPlacement(
    CRect& rectNormalPosition,
    int& nFlags,
    int& nShowCmd);

Parâmetros

rectNormalPosition
[saídas] Um retângulo que contém as coordenadas da janela do quadro principal quando ela está na posição restaurada.

nFlags
[saídas] Sinalizadores que controlam a posição da janela minimizada e como o sistema operacional alterna entre uma janela minimizada e uma janela restaurada.

nShowCmd
[saídas] Um inteiro que especifica o estado show da janela. Para obter mais informações sobre valores possíveis, consulte CWnd::ShowWindow.

Valor de retorno

Diferente de zero se for bem-sucedido; 0 caso contrário.

Comentários

Por padrão, o MFC carrega automaticamente a posição e o estado anteriores da janela do quadro principal quando o aplicativo é iniciado. Para obter mais informações sobre como essas informações são armazenadas no Registro, consulte CWinAppEx::StoreWindowPlacement.

Substitua esse método se desejar carregar informações adicionais sobre a janela do quadro principal.

CWinAppEx::m_bForceImageReset

Especifica se a estrutura redefine todas as imagens da barra de ferramentas quando recarrega a janela de quadro que contém a barra de ferramentas.

BOOL m_bForceImageReset;

Comentários

O membro m_bForceImageReset data é uma variável protegida.

CWinAppEx::OnAppContextHelp

A estrutura chama esse método quando o usuário solicita ajuda de contexto para a caixa de diálogo Personalização.

virtual void OnAppContextHelp(
    CWnd* pWndControl,
    const DWORD dwHelpIDArray[]);

Parâmetros

pWndControl
[em] Um ponteiro para um objeto window para o qual o usuário invocou ajuda de contexto.

dwHelpIDArray[]
[em] Um valor reservado.

Comentários

Este método está atualmente reservado para uso futuro. A implementação padrão não faz nada e atualmente não é chamada pela estrutura.

CWinAppEx::OnClosingMainFrame

A estrutura chama esse método quando uma janela de quadro está processando WM_CLOSE.

virtual void OnClosingMainFrame(CFrameImpl* pFrameImpl);

Parâmetros

pFrameImpl
[em] Um ponteiro para um objeto CFrameImpl.

Comentários

A implementação padrão desse método salva o estado de pFrameImpl.

CWinAppEx::OnViewDoubleClick

Chama o comando definido pelo usuário que está associado a um modo de exibição quando o usuário clica duas vezes em qualquer lugar dentro desse modo de exibição.

virtual BOOL OnViewDoubleClick(
    CWnd* pWnd,
    int iViewId);

Parâmetros

pWnd
[em] Um ponteiro para um objeto derivado do CView Class.

iViewId
[em] O ID de visualização.

Valor de retorno

TRUE se a estrutura encontrar um comando; caso contrário, FALSE.

Comentários

Para oferecer suporte ao comportamento personalizado do mouse, você deve chamar essa função ao processar a mensagem WM_LBUTTONDBLCLK. Esse método executará o comando associado ao ID de exibição fornecido por iViewId. Para obter mais informações sobre o comportamento personalizado do mouse, consulte Keyboard and Mouse Customization.

CWinAppEx::OnWorkspaceIdle

virtual BOOL OnWorkspaceIdle(CWnd*);

Parâmetros

[em] CWnd*

Valor de retorno

Comentários

CWinAppEx::PreLoadState

A estrutura chama esse método imediatamente antes de carregar o estado do aplicativo do registro.

virtual void PreLoadState();

Comentários

Substitua esse método se você quiser fazer qualquer processamento imediatamente antes que a estrutura carregue o estado do aplicativo.

CWinAppEx::PreSaveState

A estrutura chama esse método imediatamente antes de salvar o estado do aplicativo.

virtual void PreSaveState();

Comentários

Substitua esse método se você quiser fazer qualquer processamento imediatamente antes que a estrutura salve o estado do aplicativo.

CWinAppEx::ReloadWindowPlacement

Recarrega o tamanho e a localização de uma janela a partir do registo.

virtual BOOL ReloadWindowPlacement(CFrameWnd* pFrame);

Parâmetros

pFrame
[em] Um ponteiro para uma janela de quadro.

Valor de retorno

Diferente de zero se o método foi bem-sucedido; 0 se a carga falhou ou não há dados para carregar.

Comentários

Use a função CWinAppEx::StoreWindowPlacement para gravar o tamanho e o local de uma janela no registro.

CWinAppEx::SaveCustomState

A estrutura chama esse método depois que ele salva o estado do aplicativo para o registro.

virtual void SaveCustomState();

Comentários

Substitua esse método se você quiser fazer qualquer processamento depois que o aplicativo salva o estado no registro. Por padrão, esse método não faz nada.

CWinAppEx::SaveState

Grava o estado do aplicativo no registro do Windows.

virtual BOOL SaveState(
    LPCTSTR lpszSectionName = NULL,
    CFrameImpl* pFrameImpl = NULL);

BOOL SaveState(
    CMDIFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

BOOL SaveState(
    CFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

BOOL SaveState(
    COleIPFrameWndEx* pFrame,
    LPCTSTR lpszSectionName = NULL);

Parâmetros

lpszSectionName
[em] Uma cadeia de caracteres que contém o caminho relativo de uma chave do Registro.

pFrameImpl
[em] Um ponteiro para um objeto CFrameImpl. Este quadro é salvo no registro do Windows.

pFrame
[em] Um ponteiro para um objeto de janela de quadro. Este quadro é salvo no registro do Windows.

Valor de retorno

TRUE se for bem-sucedida; FALSE o contrário.

Comentários

Esse método salva o estado do aplicativo e qualquer informação de estado para a janela de quadro fornecida. Se você não fornecer uma janela de quadro, o método salvará apenas o estado do aplicativo. As informações do aplicativo incluem o estado do CMouseManager Classe, CContextMenuManager Classe, CKeyboardManager Classee o CUserToolsManager Classe.

O parâmetro lpszSectionName não é o caminho absoluto para uma entrada do Registro. É um caminho relativo que é anexado ao final da chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

CWinAppEx::SetRegistryBase

Define o caminho do Registro padrão para o aplicativo.

LPCTSTR SetRegistryBase(LPCTSTR lpszSectionName = NULL);

Parâmetros

lpszSectionName
[em] Uma cadeia de caracteres que contém o caminho de uma chave do Registro.

Valor de retorno

Uma cadeia de caracteres que contém o caminho do local do Registro padrão.

Comentários

Todos os métodos do CWinAppEx Class que acessam o registro começam em um local padrão. Use esse método para alterar esse local do Registro padrão. Use CWinAppEx::GetRegistryBase para recuperar o local do Registro padrão.

CWinAppEx::ShowPopupMenu

Exibe um menu pop-up.

virtual BOOL ShowPopupMenu(
    UINT uiMenuResId,
    const CPoint& point,
    CWnd* pWnd);

Parâmetros

uiMenuResId
[em] Um ID de recurso de menu.

point
[em] Um CPoint que especifica a posição do menu nas coordenadas da tela.

pWnd
[em] Um ponteiro para a janela que possui o menu pop-up.

Valor de retorno

Diferente de zero se o menu pop-up for exibido com êxito; 0 caso contrário.

Comentários

Esse método exibe o menu associado ao uiMenuResId.

Para suportar menus pop-up, você deve ter um objeto CContextMenuManager. Se você não tiver inicializado o objeto CContextMenuManager, ShowPopupMenu falhará.

CWinAppEx::StoreWindowPlacement

Chamado pela estrutura para gravar o tamanho e a localização da janela do quadro principal no registro.

virtual BOOL StoreWindowPlacement(
    const CRect& rectNormalPosition,
    int nFlags,
    int nShowCmd);

Parâmetros

nFlags
[em] Sinalizadores que controlam a posição da janela minimizada e como o sistema operacional alterna entre uma janela minimizada e uma janela restaurada.

nShowCmd
[em] Um inteiro que especifica o estado show da janela. Para obter mais informações sobre valores possíveis, consulte CWnd::ShowWindow.

rectNormalPosition
[em] Um retângulo que contém as coordenadas da janela do quadro principal quando ela está no estado restaurado.

Valor de retorno

Diferente de zero se for bem-sucedido; 0 caso contrário.

Comentários

Por padrão, o MFC salva automaticamente a posição e o estado da janela do quadro principal antes que o aplicativo seja encerrado. Essas informações são armazenadas no registro do Windows sob a chave WindowPlacement no local do registro padrão para seu aplicativo. Para obter mais informações sobre o local do Registro padrão do seu aplicativo, consulte CWinAppEx::GetRegistryBase.

Substitua esse método se desejar armazenar informações adicionais sobre a janela do quadro principal.

CWinAppEx::WriteBinary

Grava dados binários no registro.

BOOL WriteBinary(
    LPCTSTR lpszEntry,
    LPBYTE pData,
    UINT nBytes);

Parâmetros

lpszEntry
[em] Uma cadeia de caracteres que contém o nome de uma chave do Registro.

pData
[em] Os dados a armazenar.

nBytes
[em] O tamanho do pData em bytes.

Valor de retorno

TRUE se este método for bem-sucedido; caso contrário, FALSE.

Comentários

O parâmetro lpszEntry é o nome de uma entrada do Registro que está localizada sob a chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

Se a chave especificada por lpszEntry não existir, esse método a criará.

CWinAppEx::WriteInt

Grava dados numéricos no registro.

BOOL WriteInt(
    LPCTSTR lpszEntry,
    int nValue);

Parâmetros

lpszEntry
[em] Uma cadeia de caracteres que contém o nome de uma chave do Registro.

nValue
[em] Os dados a armazenar.

Valor de retorno

TRUE se este método for bem-sucedido; caso contrário, FALSE.

Comentários

O parâmetro lpszEntry é o nome de uma entrada do Registro localizada sob a chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

Se a chave especificada por lpszEntry não existir, esse método a criará.

CWinAppEx::WriteObject

Grava dados derivados do CObject Class no Registro.

BOOL WriteObject(
    LPCTSTR lpszEntry,
    CObject& obj);

Parâmetros

lpszEntry
[em] Uma cadeia de caracteres que contém o valor a ser definido.

obj
[em] Uma referência a CObject dados que o método armazenará.

Valor de retorno

TRUE se este método for bem-sucedido; caso contrário, FALSE.

Comentários

Esse método grava os dados obj para o valor especificado sob a chave do Registro padrão. Use CWinAppEx::GetRegistryBase para determinar a chave do Registro atual.

CWinAppEx::WriteSectionBinary

Grava dados binários em um valor no Registro.

BOOL WriteSectionBinary(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    LPBYTE pData,
    UINT nBytes);

Parâmetros

lpszSubSection
[em] Uma cadeia de caracteres que contém o nome de uma chave do Registro

lpszEntry
[em] Uma cadeia de caracteres que contém o valor a ser definido.

pData
[em] Os dados a serem gravados no registro.

nBytes
[em] O tamanho do pData em bytes.

Valor de retorno

TRUE se este método for bem-sucedido; caso contrário, FALSE.

Comentários

O parâmetro lpszSubSection não é o caminho absoluto para uma entrada do Registro. É um caminho relativo que é anexado ao final da chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

Se a chave especificada por lpszEntry não existir, esse método a criará.

CWinAppEx::WriteSectionInt

Grava dados numéricos no registro.

BOOL WriteSectionInt(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    int nValue);

Parâmetros

lpszSubSection
[em] Uma cadeia de caracteres que contém o caminho relativo de uma chave do Registro.

lpszEntry
[em] Uma cadeia de caracteres que contém o valor a ser definido.

nValue
[em] Os dados a serem gravados no registro.

Valor de retorno

TRUE se este método for bem-sucedido; caso contrário, FALSE.

Comentários

O parâmetro lpszSubSection não é um caminho absoluto para uma entrada do Registro. É um caminho relativo que é anexado à chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

Se a chave especificada por lpszEntry não existir, esse método a criará.

CWinAppEx::WriteSectionObject

Grava dados derivados da classe CObject em um valor de registro específico.

BOOL WriteSectionObject(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    CObject& obj);

Parâmetros

lpszSubSection
[em] Uma cadeia de caracteres que contém o nome de uma chave do Registro.

lpszEntry
[em] Uma cadeia de caracteres que contém o nome do valor a ser definido.

obj
[em] Os dados a armazenar.

Valor de retorno

TRUE se este método for bem-sucedido; caso contrário, FALSE.

Comentários

O parâmetro lpszSubSection não é um caminho absoluto para uma entrada do Registro. É um caminho relativo que é anexado ao final da chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

Se o valor especificado por lpszEntry não existir sob a chave do Registro especificada por lpszSubSection, esse método criará esse valor.

CWinAppEx::WriteSectionString

Grava dados de cadeia de caracteres em um valor no Registro.

BOOL WriteSectionString(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    LPCTSTR lpszValue);

Parâmetros

lpszSubSection
[em] Uma cadeia de caracteres que contém o nome de uma chave do Registro.

lpszEntry
[em] Uma cadeia de caracteres que contém o valor a ser definido.

lpszValue
[em] Os dados da cadeia de caracteres a serem gravados no Registro.

Valor de retorno

TRUE se este método for bem-sucedido; caso contrário, FALSE.

Comentários

O parâmetro lpszSubSection não é um caminho absoluto para uma entrada do Registro. É um caminho relativo que é anexado ao final da chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

Se o valor especificado por lpszEntry não existir em lpszSubSection, esse método o criará.

CWinAppEx::WriteString

Grava dados de cadeia de caracteres no registro.

BOOL WriteString(
    LPCTSTR lpszEntry,
    LPCTSTR lpszValue);

Parâmetros

lpszEntry
[em] Uma cadeia de caracteres que contém o nome de uma chave do Registro.

lpszValue
[em] Os dados a armazenar.

Valor de retorno

TRUE se este método for bem-sucedido; caso contrário, FALSE.

Comentários

O parâmetro lpszEntry é o nome de uma entrada do Registro localizada sob a chave do Registro padrão para seu aplicativo. Para obter ou definir a chave de registo predefinida, utilize os métodos CWinAppEx::GetRegistryBase e CWinAppEx::SetRegistryBase, respetivamente.

Se a chave especificada por lspzEntry não existir, esse método a criará.

Ver também

Gráfico de Hierarquia
Aulas
CWinApp Classe
CMouseManager Classe
CContextMenuManager Classe
CKeyboardManager Classe
CUserToolsManager Classe