Classe CFrameWnd

Artigo
06/10/2015

Fornece a funcionalidade de uma interface janela pop-up ou sobrepostos de (SDI) do único documento do windows do quadro, juntamente com membros para gerenciar a janela.

class CFrameWnd : public CWnd

Membros

Construtores public

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

Métodos públicos

Nome	Descrição
CFrameWnd::ActivateFrame	Torna o quadro visível e disponível para o usuário.
CFrameWnd::BeginModalState	Define a janela do quadro a janela restrita.
CFrameWnd::Create	Chame para criar e inicializar a janela do quadro do windows associada com o objeto de CFrameWnd .
CFrameWnd::CreateView	Criar um modo de exibição em um quadro que não é derivado de CView.
CFrameWnd::DockControlBar	Insere uma barra de controle.
CFrameWnd::EnableDocking	Permite que uma barra de controle é entrada.
CFrameWnd::EndModalState	Encerra o estado modal da janela do quadro. Permite que todas as janelas desativadas por BeginModalState.
CFrameWnd::FloatControlBar	Flutua uma barra de controle.
CFrameWnd::GetActiveDocument	Retorna o objeto de CDocument ativo.
CFrameWnd::GetActiveFrame	Retorna o objeto de CFrameWnd ativo.
CFrameWnd::GetActiveView	Retorna o objeto de CView ativo.
CFrameWnd::GetControlBar	Recupera a barra de controle.
CFrameWnd::GetDockState	Recupera o estado da plataforma de uma janela do quadro.
CFrameWnd::GetMenuBarState	Recupera o estado de exibição do menu no aplicativo MFC do atual.
CFrameWnd::GetMenuBarVisibility	Indica se o comportamento padrão do menu no aplicativo MFC do atual está oculto ou visível.
CFrameWnd::GetMessageBar	Retorna um ponteiro para a barra de status que pertence à janela do quadro.
CFrameWnd::GetMessageString	Recupera a mensagem correspondente a uma identificação de comando
CFrameWnd::GetTitle	Recupera o controle de barra de título relacionada.
CFrameWnd::InitialUpdateFrame	Faz com que a função de membro de OnInitialUpdate que pertence a todas as visualizações na janela do quadro a ser chamada.
CFrameWnd::InModalState	Retorna um valor indicando se uma janela de quadro chave está em um estado modal.
CFrameWnd::IsTracking	Determina se a barra separator está sendo movida atualmente.
CFrameWnd::LoadAccelTable	Chame para carregar uma tabela de aceleração.
CFrameWnd::LoadBarState	Chame para restaurar configurações da barra de controle.
CFrameWnd::LoadFrame	Chame para criar dinamicamente uma janela de quadro de informações de recurso.
CFrameWnd::NegotiateBorderSpace	Negocia o espaço da borda na janela do quadro.
CFrameWnd::OnBarCheck	Chamado sempre que uma ação é executada na barra de controle especificada.
CFrameWnd::OnContextHelp	Ajuda handles SHIFT+F1 para itens no lugar.
CFrameWnd::OnSetPreviewMode	Define a janela de quadro chave do aplicativo e fora do modo de visualização de impressão.
CFrameWnd::OnUpdateControlBarMenu	Chamado pela estrutura quando o menu associado é atualizado.
CFrameWnd::RecalcLayout	Reposiciona barras de controle do objeto de CFrameWnd .
CFrameWnd::SaveBarState	Chamada para salvar as configurações da barra de controle.
CFrameWnd::SetActivePreviewView	Designa a exibição especificado para ser o modo ativo para a visualização rico.
CFrameWnd::SetActiveView	Defina o objeto ativa de CView .
CFrameWnd::SetDockState	Chame para encaixar a janela de quadro chave na janela.
CFrameWnd::SetMenuBarState	Define o estado de exibição do menu no aplicativo MFC do atual a oculto ou exibido.
CFrameWnd::SetMenuBarVisibility	Define o comportamento padrão do menu no aplicativo MFC do atual estar ocultos ou visível.
CFrameWnd::SetMessageText	Define o texto de uma barra de status padrão.
CFrameWnd::SetProgressBarPosition	Define a posição atual para a barra de progresso Windows 7 exibida na barra de tarefas.
CFrameWnd::SetProgressBarRange	Os conjuntos variam para a barra de progresso Windows 7 exibida na barra de tarefas.
CFrameWnd::SetProgressBarState	Define o tipo e o estado do indexador de progresso exibido em um botão da barra de tarefas.
CFrameWnd::SetTaskbarOverlayIcon	Sobrecarregado. Aplica uma sobreposição a um botão da barra de tarefas para indicar o status do aplicativo ou uma notificação para o usuário.
CFrameWnd::SetTitle	Define o título da barra de controle relacionada.
CFrameWnd::ShowControlBar	Chame para mostrar a barra de controle.
CFrameWnd::ShowOwnedWindows	Mostra todas as janelas que são descendentes do objeto de CFrameWnd .

Métodos protegidos

Nome	Descrição
CFrameWnd::OnCreateClient	Cria uma janela de cliente para o quadro.
CFrameWnd::OnHideMenuBar	Chamado antes do menu no aplicativo MFC do atual está oculto.
CFrameWnd::OnShowMenuBar	Chamado antes do menu no aplicativo MFC do atual é exibido.

Membros públicos de dados

Nome	Descrição
CFrameWnd::m_bAutoMenuEnable	O automática de controles ativar e desativar a funcionalidade para itens de menu.
CFrameWnd::rectDefault	Passar este CRect estático como um parâmetro ao criar um objeto de CFrameWnd para permitir que o windows escolham o tamanho inicial e a posição da janela.

Comentários

Para criar uma janela útil do quadro para seu aplicativo, derive uma classe de CFrameWnd. Adicione variáveis de membros para a classe derivada para específico de armazenamento de dados ao seu aplicativo. Implementar funções de membro de mensagem- manipulador e um mapa de mensagem na classe derivada para especificar o que acontece quando as mensagens são todas direcionados para a janela.

Existem três maneiras para construir uma janela de quadro:

Construir-la diretamente usando Criar.
Construir-lo diretamente usando LoadFrame.
Construir-lo indiretamente usando um modelo do documento.

Antes de você chamar Criar ou LoadFrame, você deve criar o objeto de quadro- janela na heap usando o operador de new C++. Antes de chamar Criar, você também pode registrar uma classe de janela com a função global de AfxRegisterWndClass para definir estilos de ícone e da classe para o quadro.

Use a função de membro de Criar para passar parâmetros de criação do quadro como argumentos imediatos.

LoadFrame requer menos argumentos de Criar, e recupera o invés da maioria dos valores padrão de recursos, incluindo a legenda do quadro, o ícone, a tabela de aceleração, e o menu. Para ser acessíveis por LoadFrame, todos esses recursos devem ter o mesmo número de identificação de recurso (por exemplo, IDR_MAINFRAME).

Quando um objeto de CFrameWnd contém visões e documentos, eles são criados indiretamente pela estrutura em vez de diretamente pelo programador. O objeto de CDocTemplate orquestra a criação de quadro chave, a criação de modos de exibição continente, e a conexão de modos de exibição ao documento apropriado. Os parâmetros do construtor de CDocTemplate especificam CRuntimeClass das três classes envolvidas (documento, quadro, e exibição). Um objeto de CRuntimeClass é usado pela estrutura para criar dinamicamente quando novos quadros especificado pelo usuário (por exemplo, usando o comando novo Arquivo de comando ou da janela de (MDI) de interface de documentos múltiplos o novo).

Uma classe derivada de quadro- janela de CFrameWnd deve ser declarada com DECLARE_DYNCREATE para que o mecanismo de RUNTIME_CLASS anterior funcione corretamente.

CFrameWnd contém implementações padrão para executar as seguintes funções de uma janela principal em um aplicativo típico do windows:

Uma janela do quadro de CFrameWnd mantém registro de uma exibição ativa no momento que é independente da janela ativa do windows atual ou de foco de entrada. Quando o quadro reactivated, a exibição está ativa notificada chamando CView::OnActivateView.
As mensagens de comando e muitas mensagens comuns de quadro- notificação, incluindo aqueles tratadas por OnSetFocus, OnHScroll, e funções de OnVScroll de CWnd, são delegadas por uma janela do quadro de CFrameWnd para o modo ativo no momento.
Modo ativo (ou a janela filho ativa no momento do quadro MDI no caso de um quadro MDI) podem determinar a legenda da janela do quadro. Esse recurso pode ser desativado desativando o bit de estilo de FWS_ADDTOTITLE da janela do quadro.
Uma janela do quadro de CFrameWnd gerencia o posicionamento de barras de controle, de exibição, e outras janelas filho dentro da área cliente da janela do quadro. Uma janela de quadro chave também torna atualizar de tempo ocioso da barra de ferramentas e outros botões da barra de controle. Uma janela do quadro de CFrameWnd também tem implementações dos comandos para ativar /desativar e fora da barra de ferramentas e statusbar.
Uma janela do quadro de CFrameWnd gerencia a barra de menu principal. Quando um menu pop-up é exibido, a janela de quadro chave usa o mecanismo de UPDATE_COMMAND_UI para determinar quais itens de menu devem ser ativado, desativado, ou verificado. Quando o usuário seleciona um item de menu, a janela do quadro atualiza a barra de status com a cadeia de mensagem para o comando.
Uma janela do quadro de CFrameWnd possui uma tabela de aceleração opcional que transladar automaticamente aceleradores de teclado.
Uma janela do quadro de CFrameWnd tem uma identificação opcional da ajuda definido com LoadFrame que é usado para a ajuda contextual. Uma janela de quadro chave é o orchestrator de estados semimodal como modos da ajuda contextual (SHIFT+F1) e de visualização de impressão.
Uma janela do quadro de CFrameWnd abrirá um arquivo do gerenciador de arquivos arrastado e solto na janela do quadro. Se uma extensão de arquivo é registrada e associada ao aplicativo, a janela do quadro responde à solicitação de aberta (DDE) de troca dinâmicas de dados que ocorre quando o usuário abre um arquivo de dados no gerenciador de arquivos ou quando a função do windows de ShellExecute é chamada.
Se a janela de quadro chave é a janela principal do aplicativo (ou seja, CWinThread::m_pMainWnd), quando o usuário fecha o aplicativo, a janela do quadro solicita ao usuário para salvar todos os documentos alterados (para OnClose e OnQueryEndSession).
Se a janela de quadro chave é a janela principal do aplicativo, a janela de quadro chave é o contexto para executar WinHelp. Fechando a janela do quadro fechado WINHELP.EXE se foi iniciado para a ajuda para este aplicativo.

Não use o operador C++ delete para destruir uma janela do quadro. Use CWnd::DestroyWindow em vez de isso. A implementação de CFrameWnd de PostNcDestroy excluirá o objeto C++ quando a janela é destruída. Quando o usuário fecha a janela do quadro, o manipulador padrão de OnClose chamará DestroyWindow.

Para obter mais informações sobre CFrameWnd, consulte Quadro do windows.