Classe de CFrameWnd

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

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

Nome

Descrição

CFrameWnd::CFrameWnd

Constrói um objeto de CFrameWnd .

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

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

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

Hierarquia de herança

CObject

CCmdTarget

CWnd

CFrameWnd

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico de hierarquia

CWnd Class

Classe de CMDIFrameWnd

Classe de CMDIChildWnd

Classe de CView

Classe de CDocTemplate

Estrutura de CRuntimeClass