Compartilhar via

Classe CFrameWndEx

  • Artigo

Implementa a funcionalidade de uma janela de SDI (interface de documento único) do Windows sobreposta ou de quadro pop-up e fornece membros para gerenciar a janela. Estende a classe CFrameWnd.

Sintaxe

class CFrameWndEx : public CFrameWnd

Membros

Métodos públicos

Nome Descrição
CFrameWndEx::ActiveItemRecalcLayout Ajusta o layout do item do cliente OLE e da área de cliente do quadro.
CFrameWndEx::AddDockSite Esse método não é usado.
CFrameWndEx::AddPane Registra uma barra de controle com o gerenciador de encaixe.
CFrameWndEx::AdjustDockingLayout Recalcula o layout de todos os painéis encaixados na janela com moldura.
CFrameWndEx::DelayUpdateFrameMenu Define o menu de quadros e o atualiza quando o processamento de comando está ocioso.
CFrameWndEx::DockPane Encaixa o painel especificado na janela com moldura.
CFrameWndEx::DockPaneLeftOf Encaixa um painel à esquerda de outro painel.
CFrameWndEx::EnableAutoHidePanes Habilita o modo de ocultação automática para os painéis quando eles são encaixados nos lados especificados da janela com moldura principal.
CFrameWndEx::EnableDocking Habilita o encaixe dos painéis que pertencem à janela com moldura.
CFrameWndEx::EnableFullScreenMainMenu Mostra ou oculta o menu principal no modo de tela inteira.
CFrameWndEx::EnableFullScreenMode Habilita o modo de tela inteira para a janela com moldura.
CFrameWndEx::EnableLoadDockState Habilita ou desabilita o carregamento do estado de encaixe.
CFrameWndEx::EnablePaneMenu Habilita ou desabilita a manipulação automática do menu do painel.
CFrameWndEx::GetActivePopup Retorna um ponteiro para o menu de item pop-up exibido no momento.
CFrameWndEx::GetDefaultResId Retorna a ID do recurso especificada quando a estrutura carregou a janela com moldura.
CFrameWndEx::GetDockingManager Recupera o objeto Classe CDockingManager para a janela com moldura.
CFrameWndEx::GetMenuBar Retorna um ponteiro para o objeto da barra de menus anexado à janela com moldura.
CFrameWndEx::GetPane Retorna um ponteiro para o painel que tem a ID especificada.
CFrameWndEx::GetRibbonBar Recupera o controle da barra de faixa de opções para o quadro.
CFrameWndEx::GetTearOffBars Retorna uma lista de objetos do painel que estão em um estado de destacável.
CFrameWndEx::GetToolbarButtonToolTipText Chamado pela estrutura quando o aplicativo exibe a dica de ferramenta para um botão de barra de ferramentas.
CFrameWndEx::InsertPane Registra um painel com o gerenciador de encaixe.
CFrameWndEx::IsFullScreen Determina se a janela com moldura está no modo de tela inteira.
CFrameWndEx::IsMenuBarAvailable Determina se o ponteiro para o objeto da barra de menus é válido.
CFrameWndEx::IsPointNearDockSite Indica se o ponto está localizado em uma zona de alinhamento.
CFrameWndEx::IsPrintPreview Indica se a janela com moldura está no modo de visualização de impressão.
CFrameWndEx::LoadFrame Esse método é chamado após a construção para criar a janela com moldura e carregar seus recursos.
CFrameWndEx::NegotiateBorderSpace Implementa a negociação de borda do cliente OLE.
CFrameWndEx::OnActivate A estrutura chama esse método quando a entrada de usuário é alternada para ou para longe do quadro.
CFrameWndEx::OnActivateApp Chamado pela estrutura quando o aplicativo é selecionado ou desmarcado.
CFrameWndEx::OnChangeVisualManager Chamado pela estrutura quando uma alteração no quadro requer uma mudança no gerenciador visual.
CFrameWndEx::OnClose A estrutura chama esse método para fechar o quadro.
CFrameWndEx::OnCloseDockingPane Chamado pela estrutura quando o usuário clica no botão Fechar em um painel de encaixe.
CFrameWndEx::OnCloseMiniFrame Chamado pela estrutura quando o usuário clica no botão Fechar em uma janela com minimoldura flutuante.
CFrameWndEx::OnClosePopupMenu Chamado pela estrutura quando um menu de item pop-up ativo processa uma mensagem WM_DESTROY.
CFrameWndEx::OnCmdMsg Expede mensagens de comando.
CFrameWndEx::OnContextHelp Chamado pela estrutura para exibir a ajuda relacionada ao contexto.
CFrameWndEx::OnCreate Chamado pela estrutura após a criação do quadro.
CFrameWndEx::OnDestroy Chamado pela estrutura quando o quadro é destruído.
CFrameWndEx::OnDrawMenuImage Chamado pela estrutura quando o aplicativo desenha a imagem associada a um item de menu.
CFrameWndEx::OnDrawMenuLogo Chamado pela estrutura quando um objeto CMFCPopupMenu processa uma mensagem WM_PAINT.
CFrameWndEx::OnDWMCompositionChanged Chamado pela estrutura quando a composição do DWM (Gerenciador de Janelas da Área de Trabalho) foi habilitada ou desabilitada.
CFrameWndEx::OnExitSizeMove Chamado pela estrutura quando o quadro para de mover ou redimensionar.
CFrameWndEx::OnGetMinMaxInfo Chamado pela estrutura quando o quadro é redimensionado para definir os limites de dimensão da janela.
CFrameWndEx::OnIdleUpdateCmdUI Chamado pela estrutura para atualizar a exibição do quadro quando o processamento de comando está ocioso.
CFrameWndEx::OnLButtonDown A estrutura chama esse método quando o usuário clica no botão esquerdo do mouse.
CFrameWndEx::OnLButtonUp A estrutura chama esse método quando o usuário libera o botão esquerdo do mouse.
CFrameWndEx::OnMenuButtonToolHitTest Chamado pela estrutura quando um objeto CMFCToolBarButton processa uma mensagem WM_NCHITTEST.
CFrameWndEx::OnMenuChar Chamado pela estrutura quando um menu é exibido e o usuário pressiona uma tecla que não corresponde a um comando.
CFrameWndEx::OnMouseMove A estrutura chama esse método quando o ponteiro é movido.
CFrameWndEx::OnMoveMiniFrame Chamado pela estrutura quando uma janela do painel é movida.
CFrameWndEx::OnNcActivate Chamado pela estrutura quando a área não cliente do quadro deve ser redesenhada para indicar uma alteração no estado ativo.
CFrameWndEx::OnNcCalcSize Chamado pela estrutura quando o tamanho e a posição da área do cliente devem ser calculados.
CFrameWndEx::OnNcHitTest Chamado pela estrutura quando o ponteiro se move ou quando um botão do mouse é pressionado ou liberado.
CFrameWndEx::OnNcMouseMove Chamado pela estrutura quando o ponteiro se move em uma área não cliente.
CFrameWndEx::OnNcPaint Chamado pela estrutura quando a área não cliente deve ser pintada.
CFrameWndEx::OnPaneCheck Chamado pela estrutura para controlar a visibilidade de um painel.
CFrameWndEx::OnPostPreviewFrame Chamado pela estrutura quando o usuário alterou o modo de visualização de impressão.
CFrameWndEx::OnPowerBroadcast Chamado pela estrutura quando um evento de gerenciamento de energia ocorre.
CFrameWndEx::OnSetMenu Chamado pela estrutura para substituir o menu da janela com moldura.
CFrameWndEx::OnSetPreviewMode Chamado pela estrutura para definir o modo de visualização de impressão para o quadro.
CFrameWndEx::OnSetText Chamado pela estrutura para definir o texto de uma janela.
CFrameWndEx::OnShowCustomizePane Chamado pela estrutura quando um painel de personalização rápida é habilitado.
CFrameWndEx::OnShowPanes Chamado pela estrutura para exibir ou ocultar painéis.
CFrameWndEx::OnShowPopupMenu Chamado pela estrutura quando um menu de item pop-up é habilitado.
CFrameWndEx::OnSize A estrutura chama esse método após a alteração do tamanho do quadro.
CFrameWndEx::OnSizing A estrutura chama esse método quando o usuário redimensiona o quadro.
CFrameWndEx::OnSysColorChange Chamado pela estrutura quando as cores do sistema mudam.
CFrameWndEx::OnTearOffMenu Chamado pela estrutura quando um menu que tem uma barra destacável é habilitado.
CFrameWndEx::OnToolbarContextMenu Chamado pela estrutura para compilar um menu de contexto da barra de ferramentas.
CFrameWndEx::OnToolbarCreateNew A estrutura chama esse método para criar uma nova barra de ferramentas.
CFrameWndEx::OnToolbarDelete Chamado pela estrutura quando uma barra de ferramentas é excluída.
CFrameWndEx::OnUpdateFrameMenu Chamado pela estrutura para definir o menu de quadros.
CFrameWndEx::OnUpdateFrameTitle A estrutura chama esse método para atualizar a barra de título da janela com moldura.
CFrameWndEx::OnUpdatePaneMenu Chamado pela estrutura para atualizar o menu do painel.
CFrameWndEx::OnWindowPosChanged Chamado pela estrutura quando o tamanho do quadro, a posição ou a ordem em z foram alterados devido a uma chamada para um método de gerenciamento de janela.
CFrameWndEx::PaneFromPoint Retorna o painel de encaixe que contém o ponto especificado.
CFrameWndEx::PreTranslateMessage Identifica mensagens de janela específicas antes de serem enviadas.
CFrameWndEx::RecalcLayout Ajusta o layout do quadro e as janelas filho.
CFrameWndEx::RemovePaneFromDockManager Cancela o registro de um painel e o remove da lista interna no gerenciador de encaixe.
CFrameWndEx::SetDockState Restaura o layout de encaixe para o estado de encaixe armazenado no registro.
CFrameWndEx::SetPrintPreviewFrame Define a janela com moldura de visualização de impressão.
CFrameWndEx::SetupToolbarMenu Insere comandos definidos pelo usuário em um menu da barra de ferramentas.
CFrameWndEx::ShowFullScreen Alterna o quadro principal entre a tela inteira e os modos regulares.
CFrameWndEx::ShowPane Mostra ou oculta o painel especificado.
CFrameWndEx::UpdateCaption Chamado pela estrutura para atualizar a legenda do quadro de janela.
[Aplicativo CFrameWndEx::WinHelp``](#winhelp)|Invokes either the WinHelp' ou ajuda relacionada ao contexto.

Exemplo

O exemplo a seguir demonstra como herdar uma classe da classe CFrameWndEx. O exemplo ilustra as assinaturas de método na subclasse e como substituir o método OnShowPopupMenu. Este snippet de código faz parte do exemplo do Word Pad.

class CMainFrame : public CFrameWndEx
{
protected: // create from serialization only
   CMainFrame();
   DECLARE_DYNCREATE(CMainFrame)

   // Attributes
public:
   HICON m_hIconDoc;
   HICON m_hIconText;
   HICON m_hIconWrite;
   HICON GetIcon(int nDocType);

   // Operations
public:
   void UpdateMRUFilesList()
   {
      m_wndTaskPane.UpdateMRUFilesList();
   }

   void OnChangeLook();

   // Overrides
   // ClassWizard generated virtual function overrides
   //{{AFX_VIRTUAL(CMainFrame)
public:
   virtual void ActivateFrame(int nCmdShow = -1);
   virtual BOOL LoadFrame(UINT nIDResource,
                          DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
                          CWnd *pParentWnd = NULL,
                          CCreateContext *pContext = NULL);

protected:
   virtual BOOL PreCreateWindow(CREATESTRUCT &cs);
   virtual BOOL OnCommand(WPARAM wParam, LPARAM lParam);
   //}}AFX_VIRTUAL

   virtual BOOL OnShowPopupMenu(CMFCPopupMenu *pMenuPopup);
   virtual BOOL OnTearOffMenu(CMFCPopupMenu *pMenuPopup, CPane *pBar);

protected:
   void AdjustObjectSubmenu(CMFCPopupMenu *pMenuPopup);
   void AdjustColorsMenu(CMFCPopupMenu *pMenuPopup, UINT uiId);

   // Implementation
public:
   virtual ~CMainFrame();
#ifdef _DEBUG
   virtual void AssertValid() const;
   virtual void Dump(CDumpContext &dc) const;
#endif

public:
   CMFCMenuBar m_wndMenuBar;
   CMFCToolBar m_wndToolBar;
   CMFCStatusBar m_wndStatusBar;
   CFormatBar m_wndFormatBar;
   CRulerBar m_wndRulerBar;
   CTaskPane m_wndTaskPane;

protected: // control bar embedded members
   BOOL CreateMenuBar();
   BOOL CreateToolBar();
   BOOL CreateFormatBar();
   BOOL CreateStatusBar();
   BOOL CreateRulerBar();
   BOOL CreateTaskPane();

   // Generated message map functions
protected:
   //{{AFX_MSG(CMainFrame)
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
   afx_msg void OnSysColorChange();
   afx_msg void OnSize(UINT nType, int cx, int cy);
   afx_msg void OnMove(int x, int y);
   afx_msg void OnHelpFinder();
   afx_msg void OnDropFiles(HDROP hDropInfo);
   afx_msg void OnFontChange();
   afx_msg BOOL OnQueryNewPalette();
   afx_msg void OnPaletteChanged(CWnd *pFocusWnd);
   afx_msg void OnDevModeChange(LPTSTR lpDeviceName);
   afx_msg void OnViewCustomize();
   afx_msg void OnViewFullScreen();
   //}}AFX_MSG
   afx_msg LRESULT OnBarState(WPARAM wParam, LPARAM lParam);
   afx_msg LRESULT OnOpenMsg(WPARAM wParam, LPARAM lParam);
   afx_msg LRESULT OnHelpCustomizeToolbars(WPARAM wp, LPARAM lp);
   afx_msg LRESULT OnStartCustomize(WPARAM wp, LPARAM lp);
   afx_msg LRESULT OnToolbarCreateNew(WPARAM, LPARAM);
   afx_msg LRESULT OnGetDocumentColors(WPARAM, LPARAM);
   afx_msg void OnDummy();
   afx_msg void OnAskQuestion();
   DECLARE_MESSAGE_MAP()
};

// CMainFrame is application-defined object of type CFrameWndEx
BOOL CMainFrame::OnShowPopupMenu(CMFCPopupMenu *pMenuPopup)
{
   BOOL bRes = CFrameWndEx::OnShowPopupMenu(pMenuPopup);

   if (pMenuPopup != NULL && !pMenuPopup->IsCustomizePane())
   {
      AdjustObjectSubmenu(pMenuPopup);
      AdjustColorsMenu(pMenuPopup, ID_CHAR_COLOR);
   }

   return bRes;
}

Hierarquia de herança

CObject

CCmdTarget

CWnd

CFrameWnd

CFrameWndEx

Requisitos

Cabeçalhoafxframewndex.h:

CFrameWndEx::ActiveItemRecalcLayout

Ajusta o layout do item do cliente OLE e da área de cliente do quadro.

void ActiveItemRecalcLayout();

Comentários

CFrameWndEx::AddPane

Registra uma barra de controle com o gerenciador de encaixe.

BOOL AddPane(
    CBasePane* pControlBar,
    BOOL bTail=TRUE);

Parâmetros

pControlBar
[in] Um painel da barra de controle a ser registrado.

bTail
[in] TRUE Se você quiser adicionar o painel da barra de controle ao final da lista; caso contrário, FALSE.

Valor de Devolução

TRUE se a barra de controle foi registrada com êxito; caso contrário, FALSE.

CFrameWndEx::AdjustDockingLayout

Recalcula o layout de todos os painéis encaixados na janela com moldura.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Parâmetros

hdwp
Um identificador para uma estrutura que contém as posições de várias janelas. .

Comentários

A estrutura hdwp é inicializada pelo método BeginDeferWindowPos.

CFrameWndEx::DelayUpdateFrameMenu

Define o menu de quadros e o atualiza quando o processamento de comando está ocioso.

virtual void DelayUpdateFrameMenu(HMENU hMenuAlt);

Parâmetros

hMenuAlt
[in] Manipule para um menu alternativo.

Comentários

CFrameWndEx::DockPane

Encaixa o painel especificado na janela com moldura.

void DockPane(
    CBasePane* pBar,
    UINT nDockBarID=0,
    LPCRECT lpRect=NULL);

Parâmetros

pBar
[in] Um ponteiro para a barra de controle a ser encaixada.

nDockBarID
[in] A ID do lado da janela com moldura a ser encaixada.

lpRect
[in] Um ponteiro para uma estrutura Rect constante que especifica a posição e o tamanho da tela da janela.

Comentários

O parâmetro nDockBarID pode ter um dos seguintes valores:

  • AFX_IDW_DOCKBAR_TOP

  • AFX_IDW_DOCKBAR_BOTTOM

  • AFX_IDW_DOCKBAR_LEFT

  • AFX_IDW_DOCKBAR_RIGHT

CFrameWndEx::DockPaneLeftOf

Encaixa o painel especificado à esquerda de outro painel.

BOOL DockPaneLeftOf(
    CPane* pBar,
    CPane* pLeftOf);

Parâmetros

pBar
[in] Um ponteiro para o objeto do painel a ser encaixado.

pLeftOf
[in] Um ponteiro para o painel à esquerda para encaixar o painel especificado por pBar.

Valor de Devolução

TRUE se pBar for encaixado com êxito. Caso contrário, FALSE.

Comentários

O método usa a barra de ferramentas especificada pelo parâmetro pBar e a encaixa no lado esquerdo da barra de ferramentas especificada pelo parâmetro pLeftOf.

CFrameWndEx::EnableAutoHidePanes

Habilita o modo de ocultação automática para o painel quando ele é encaixado no lado especificado da janela com moldura principal.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parâmetros

dwDockStyle
[in] Especifica o lado da janela com moldura principal para encaixar o painel.

Valor de Devolução

TRUE se um painel de barras for encaixado com êxito no lado da janela com moldura especificada por dwDockStyle, caso contrário FALSE.

Comentários

dwDockStyle pode ter um dos seguintes valores:

  • CBRS_ALIGN_TOP: permite que a barra de controle seja encaixada na parte superior da área do cliente de uma janela com moldura.

  • CBRS_ALIGN_BOTTOM: permite que a barra de controle seja encaixada na parte inferior da área do cliente de uma janela com moldura.

  • CBRS_ALIGN_LEFT: permite que a barra de controle seja encaixada na parte esquerda da área do cliente de uma janela com moldura.

  • CBRS_ALIGN_RIGHT: permite que a barra de controle seja encaixada na parte direita da área do cliente de uma janela com moldura.

CFrameWndEx::EnableDocking

Habilita o encaixe dos painéis da janela com moldura.

BOOL EnableDocking(DWORD dwDockStyle);

Parâmetros

dwDockStyle
[in] Especifica o lado da janela com moldura principal onde a barra do painel encaixa.

Valor de Devolução

TRUE se um painel de barras puder ser encaixado com êxito no lado especificado. Caso contrário, FALSE.

Comentários

O parâmetro dwDockStyle pode ter um dos seguintes valores:

  • CBRS_ALIGN_TOP

  • CBRS_ALIGN_BOTTOM

  • CBRS_ALIGN_LEFT

  • CBRS_ALIGN_RIGHT

CFrameWndEx::EnableFullScreenMainMenu

Mostra ou oculta o menu principal no modo de tela inteira.

void EnableFullScreenMainMenu(BOOL bEnableMenu);

Parâmetros

bEnableMenu
[in] TRUE para mostrar o menu principal em um modo de tela inteira; caso contrário, FALSE.

CFrameWndEx::EnableFullScreenMode

Habilita o modo de tela inteira para a janela com moldura.

void EnableFullScreenMode(UINT uiFullScreenCmd);

Parâmetros

uiFullScreenCmd
[in] A ID de um comando que habilita e desabilita o modo de tela inteira.

Comentários

No modo de tela inteira, todas as barras de controle de encaixe, barras de ferramentas e menu ficam oculto e o modo de exibição ativo é redimensionado para ocupar a tela inteira.

Ao habilitar o modo de tela inteira, você deve especificar uma ID do comando que habilite ou desabilite o modo de tela inteira. Você pode chamar EnableFullScreenMode a partir da função OnCreate do quadro principal. Quando uma janela com moldura é alternada para o modo de tela inteira, a estrutura cria uma barra de ferramentas flutuante com um botão que tem a ID de comando especificada.

Se você desejar manter o menu principal na tela, chame CFrameWndEx::EnableFullScreenMainMenu.

CFrameWndEx::EnableLoadDockState

Habilita ou desabilita o carregamento do estado de encaixe.

void EnableLoadDockState(BOOL bEnable=TRUE);

Parâmetros

bEnable
[in] TRUE para habilitar o carregamento do estado de encaixe para FALSE desabilitar o carregamento do estado de encaixe.

CFrameWndEx::EnablePaneMenu

Habilita ou desabilita a manipulação automática do menu do painel.

void EnablePaneMenu(
    BOOL bEnable,
    UINT uiCustomizeCmd,
    const CString& strCustomizeLabel,
    UINT uiViewToolbarsMenuEntryID,
    BOOL bContextMenuShowsToolbarsOnly=FALSE,
    BOOL bViewMenuShowsToolbarsOnly=FALSE);

Parâmetros

bEnable
[in] TRUE para habilitar a manipulação automática dos menus pop-up da barra de controle; FALSE para desabilitar a manipulação automática dos menus pop-up da barra de controle.

uiCustomizeCmd
[in] A ID de comando do item de menu Personalizar.

strCustomizeLabel
[in] O rótulo a ser exibido para o item de menu Personalizar

uiViewToolbarsMenuEntryID
[in] A ID de um item de menu da barra de ferramentas que abre o menu pop-up na barra de controle.

bContextMenuShowsToolbarsOnly
[in] Se TRUE, o menu de contexto da barra de controle exibirá apenas a lista da barras de ferramentas. Se FALSE, o menu exibe a lista das barras de ferramentas e as barras de encaixe.

bViewMenuShowsToolbarsOnly
[in] Se TRUE, o menu da barra de controle exibirá apenas a lista da barras de ferramentas. Se FALSE, o menu exibe a lista das barras de ferramentas e as barras de encaixe.

CFrameWndEx::GetActivePopup

Retorna um ponteiro para o menu de item pop-up exibido no momento.

CMFCPopupMenu* GetActivePopup() const;

Valor de Devolução

Um ponteiro para o menu de item pop-up exibido no momento, caso contrário, NULL.

CFrameWndEx::GetDefaultResId

Retorna a ID do recurso especificada quando a estrutura carregou a janela com moldura.

UINT GetDefaultResId() const;

Valor de Devolução

O valor da ID do recurso especificado pelo usuário quando a estrutura carregou a janela com moldura. Zero se a janela com moldura não tiver uma barra de menus.

CFrameWndEx::GetDockingManager

Recupera o objeto Classe CDockingManager para a janela com moldura.

CDockingManager* GetDockingManager();

Valor de Devolução

Um ponteiro para a Classe CDockingManager.

Comentários

A janela com moldura cria e usa um objeto de Classe CDockingManager para gerenciar o encaixe da janela filho.

CFrameWndEx::GetMenuBar

Retorna um ponteiro para o objeto da barra de menus anexado à janela com moldura.

const CMFCMenuBar* GetMenuBar() const;

Valor de Devolução

Um ponteiro para o objeto da barra de menus anexado à janela com moldura.

CFrameWndEx::GetPane

Retorna um ponteiro para o painel que tem a ID especificada.

CBasePane* GetPane(UINT nID);

Parâmetros

nID
[entrada] A ID de controle.

Valor de Devolução

Um ponteiro para o painel que tem a ID especificada. NULL se não existir tal painel.

CFrameWndEx::GetRibbonBar

Recupera o controle da barra de faixa de opções para o quadro.

CMFCRibbonBar* GetRibbonBar();

Valor de Devolução

Ponteiro para a CMFCRibbonBar Classe do quadro.

Comentários

CFrameWndEx::GetTearOffBars

Retorna uma lista de objetos do painel que estão em um estado de destacável.

const CObList& GetTearOffBars() const;

Valor de Devolução

Uma referência a um objeto CObList que contém uma coleção de ponteiros para objetos do painel que estão em um estado destacável.

CFrameWndEx::GetToolbarButtonToolTipText

Chamado pela estrutura quando o aplicativo exibe a dica de ferramenta para um botão de barra de ferramentas.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton* pButton,
    CString& strTTText);

Parâmetros

pButton
[in] Um ponteiro para um botão de barra de ferramentas.

strTTText
[in] O texto da dica de ferramenta a ser exibido para o botão.

Valor de Devolução

TRUE se a dica de ferramenta tiver sido exibida. Caso contrário, FALSE.

Comentários

Por padrão, esse método não faz nada. Substitua esse método se quiser exibir dica de ferramenta para o botão de barra de ferramentas.

CFrameWndEx::InsertPane

Insere um painel em uma lista de barras de controle e o registra no gerenciador de encaixe.

BOOL InsertPane(
    CBasePane* pControlBar,
    CBasePane* pTarget,
    BOOL bAfter=TRUE);

Parâmetros

pControlBar
Um ponteiro para uma barra de controle a ser inserida na lista de barras de controle e registrado no gerenciador de encaixe.

pTarget
Um ponteiro para uma barra de controle antes ou depois da qual o painel deve ser inserido.

bAfter
TRUE se você quiser inserir pControlBar depois de pTarget; caso contrário, FALSE.

Valor de Devolução

TRUE se a barra de controle foi inserida e registrada com êxito; caso contrário, FALSE.

Comentários

Você deve registrar cada barra de controle usando a Classe CDockingManager para fazer parte do layout de encaixe.

CFrameWndEx::IsFullScreen

Determina se a janela com moldura está no modo de tela inteira.

BOOL IsFullScreen() const;

Valor de Devolução

TRUE se a janela com moldura estiver no modo de tela inteira; caso contrário FALSE.

Comentários

Você pode definir o modo de tela inteira chamando o método CFrameWndEx::EnableFullScreenMode.

CFrameWndEx::IsMenuBarAvailable

Determina se o ponteiro para o objeto da barra de menus é válido.

BOOL IsMenuBarAvailable() const;

Valor de Devolução

TRUE se a janela com moldura não tiver uma barra de menus; caso contrário FALSE.

CFrameWndEx::IsPointNearDockSite

Determina se o ponto está localizado em uma zona de alinhamento.

BOOL IsPointNearDockSite(
    CPoint point,
    DWORD& dwBarAlignment,
    BOOL& bOuterEdge) const;

Parâmetros

point
[in] A posição do ponto.

dwBarAlignment
[out] Onde o ponto está alinhado. Consulte a tabela na seção Comentários para obter valores possíveis.

bOuterEdge
[out] TRUE se o ponto estiver localizado perto da borda do quadro; FALSE se o ponto estiver localizado em uma área de cliente.

Valor de Devolução

TRUE se o ponto estiver localizado em uma zona de alinhamento; caso contrário, FALSE.

Comentários

A tabela a seguir lista os possíveis valores do parâmetro dwBarAlignment.

Valor Descrição
CBRS_ALIGN_TOP Alinhado ao topo.
CBRS_ALIGN_RIGHT Alinhado à direita.
CBRS_ALIGN_BOTTOM Alinhado à parte inferior.
CBRS_ALIGN_LEFT Alinhado à esquerda.

CFrameWndEx::IsPrintPreview

Determina se a janela com moldura está no modo de visualização de impressão.

BOOL IsPrintPreview();

Valor de Devolução

TRUE se a janela com moldura estiver no modo de visualização de impressão; caso contrário, FALSE.

Comentários

CFrameWndEx::LoadFrame

Esse método é chamado após a construção para criar a janela com moldura e carregar seus recursos.

virtual BOOL LoadFrame(
    UINT nIDResource,
    DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
    CWnd* pParentWnd = NULL,
    CCreateContext* pContext = NULL);

Parâmetros

nIDResource
[in] A ID do recurso usada para carregar todos os recursos do quadro.

dwDefaultStyle
[in] O estilo da janela com moldura padrão.

pParentWnd
[in] Ponteiro para a janela pai do quadro.

pContext
[in] Ponteiro para uma classe de Estrutura CCreateContext usada pela estrutura durante a criação do aplicativo.

Valor de Devolução

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

Comentários

CFrameWndEx::NegotiateBorderSpace

Implementa a negociação de borda do cliente OLE.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Parâmetros

nBorderCmd
[in] O comando de negociação de fronteira. Consulte a seção Comentários para obter os valores possíveis.

lpRectBorder
[in, out] Dimensões da borda.

Valor de Devolução

TRUE se o layout precisar ser recalculado; caso contrário, FALSE.

Comentários

A tabela a seguir lista os possíveis valores do parâmetro nBorderCmd.

borderGet
Obter espaço do cliente OLE disponível.

borderRequest
Solicitar espaço do cliente OLE.

borderSet
Definir espaço do cliente OLE.

CFrameWndEx::OnActivate

A estrutura chama esse método quando a entrada de usuário é alternada para ou para longe do quadro.

afx_msg void OnActivate(
    UINT nState,
    CWnd* pWndOther,
    BOOL bMinimized);

Parâmetros

nState
[in] Se o quadro está ativo ou inativo. Consulte a tabela na seção Comentários para obter valores possíveis.

pWndOther
[in] Ponteiro para outra janela que está alternando a entrada do usuário com a atual.

bMinimized
[in] O estado minimizado do quadro. TRUE se o quadro estiver minimizado; caso contrário, FALSE.

Comentários

A tabela a seguir lista os possíveis valores do parâmetro nState.

Valor Descrição
WA_ACTIVE O quadro é selecionado por um método diferente de um clique do mouse.
WA_CLICKACTIVE O quadro é selecionado por um clique do mouse.
WA_INACTIVE O quadro não está selecionado.

CFrameWndEx::OnActivateApp

Chamado pela estrutura quando o aplicativo é selecionado ou desmarcado.

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

Parâmetros

bActive
[in] TRUE se o aplicativo estiver selecionado; FALSE se o aplicativo não estiver selecionado.

dwThreadID
[in] Esse parâmetro não é usado.

Comentários

CFrameWndEx::OnChangeVisualManager

Chamado pela estrutura quando uma alteração no quadro requer uma mudança no gerenciador visual.

afx_msg LRESULT OnChangeVisualManager(
    WPARAM wParam,
    LPARAM lParam);

Parâmetros

wParam
[in] Esse parâmetro não é usado.

lParam
[in] Esse parâmetro não é usado.

Valor de Devolução

Sempre retorna 0.

Comentários

CFrameWndEx::OnClose

A estrutura chama esse método para fechar o quadro.

afx_msg void OnClose();

Comentários

Se o quadro estiver no modo de visualização de impressão, ele enviará uma mensagem do Windows para fechar a visualização de impressão; caso contrário, se um cliente OLE for hospedado pelo quadro, o cliente será desativado.

CFrameWndEx::OnCloseDockingPane

Chamado pela estrutura quando o usuário clica no botão Fechar em um painel de encaixe.

virtual BOOL OnCloseDockingPane(CDockablePane* pPane);

Valor de Devolução

TRUE se a barra de encaixe puder ser fechada. FALSE; caso contrário

Comentários

A implementação padrão não faz nada. Substitua esse método se você quiser manipular a ocultação da barra de encaixe.

CFrameWndEx::OnCloseMiniFrame

Chamado pela estrutura quando o usuário clica no botão Fechar em uma janela com minimoldura flutuante.

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd* pWnd);

Valor de Devolução

TRUE se uma janela com minimoldura flutuante puder ser fechada. Caso contrário, FALSE.

Comentários

A implementação padrão não tem ação. Substitua esse método se quiser processar o ocultamento de uma janela com minimoldura flutuante.

CFrameWndEx::OnClosePopupMenu

Chamado pela estrutura quando um menu de item pop-up ativo processa uma mensagem WM_DESTROY.

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

Parâmetros

pMenuPopup
Um ponteiro para um menu de item pop-up.

Comentários

A estrutura envia uma mensagem WM_DESTROY quando está prestes a fechar a janela. Substitua esse método se você quiser manipular notificações de objetos CMFCPopupMenu que pertencem à janela com moldura quando um objeto CMFCPopupMenu estiver processando uma mensagem WM_DESTROY enviada pela estrutura quando a janela estiver sendo fechada.

CFrameWndEx::OnCmdMsg

Expede mensagens de comando.

virtual BOOL OnCmdMsg(
    UINT nID,
    int nCode,
    void* pExtra,
    AFX_CMDHANDLERINFO* pHandlerInfo);

Parâmetros

nID
[in] A ID de comando.

nCode
[in] Categoria da mensagem de comando.

pExtra
[in, out] Ponteiro para um objeto de comando.

pHandlerInfo
[in, out] Ponteiro para uma estrutura de manipulador de comandos.

Valor de Devolução

TRUE se a mensagem de comando tiver sido tratada; caso contrário, FALSE.

Comentários

CFrameWndEx::OnContextHelp

Chamado pela estrutura para exibir a ajuda relacionada ao contexto.

afx_msg void OnContextHelp();

Comentários

CFrameWndEx::OnCreate

Chamado pela estrutura após a criação do quadro.

afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

Parâmetros

lpCreateStruct
[in] Um ponteiro para a Estrutura CREATESTRUCT do novo quadro.

Valor de Devolução

0 para continuar com a criação do quadro; -1 para destruir o quadro.

Comentários

CFrameWndEx::OnDestroy

Chamado pela estrutura quando o quadro é destruído.

afx_msg void OnDestroy();

Comentários

A tabela do acelerador e todas as janelas são destruídas.

CFrameWndEx::OnDrawMenuImage

Chamado pela estrutura quando o aplicativo desenha a imagem associada a um item de menu.

virtual BOOL OnDrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuButton,
    const CRect& rectImage);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pMenuButton
[in] Um ponteiro para um botão do menu cuja imagem está sendo renderizada.

rectImage
[in] Um ponteiro para uma estrutura Rect que especifica a posição da tela e o tamanho da imagem.

Valor de Devolução

TRUE se a estrutura renderizar a imagem com êxito; caso contrário, FALSE.

Comentários

Substitua esse método se desejar personalizar a renderização de imagem para os itens de menu que pertencem à barra de menus de propriedade do objeto derivado de CFrameWndEx.

Chamado pela estrutura quando um objeto CMFCPopupMenu processa uma mensagem WM_PAINT.

virtual void OnDrawMenuLogo(
    CDC* pDC,
    CMFCPopupMenu* pMenu,
    const CRect& rectLogo);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

pMenu
[in] Um ponteiro para o item de menu.

rectLogo
[in] Uma referência a uma estrutura CRect constante que especifica a posição da tela e o tamanho do logotipo do menu.

Comentários

Substitua essa função se quiser exibir um logotipo no menu de item pop-up que pertence à barra de menus de propriedade do objeto derivado de CFrameWndEx.

CFrameWndEx::OnDWMCompositionChanged

Chamado pela estrutura quando a composição do DWM (Gerenciador de Janelas da Área de Trabalho) foi habilitada ou desabilitada.

afx_msg LRESULT OnDWMCompositionChanged(
    WPARAM wp,
    LPARAM lp);

Parâmetros

wp
[in] Esse parâmetro não é usado.

lp
[in] Esse parâmetro não é usado.

Valor de Devolução

Sempre retorna 0.

Comentários

CFrameWndEx::OnExitSizeMove

Chamado pela estrutura quando o quadro para de mover ou redimensionar.

LRESULT OnExitSizeMove(
    WPARAM wp,
    LPARAM lp);

Parâmetros

wp
[in] Esse parâmetro não é usado.

lp
[in] Esse parâmetro não é usado.

Valor de Devolução

Sempre retorna 0.

Comentários

CFrameWndEx::OnGetMinMaxInfo

Chamado pela estrutura quando o quadro é redimensionado para definir os limites de dimensão da janela.

afx_msg void OnGetMinMaxInfo(MINMAXINFO FAR* lpMMI);

Parâmetros

lpMMI
[in] Ponteiro para uma estrutura MINMAXINFO.

Comentários

CFrameWndEx::OnIdleUpdateCmdUI

Chamado pela estrutura para atualizar a exibição do quadro quando o processamento de comando está ocioso.

afx_msg LRESULT OnIdleUpdateCmdUI(
    WPARAM wParam = 0,
    LPARAM lParam = 0);

Parâmetros

wParam
[in] Esse parâmetro não é usado.

lParam
[in] Esse parâmetro não é usado.

Valor de Devolução

Sempre retorna 0.

Comentários

CFrameWndEx::OnLButtonDown

A estrutura chama esse método quando o usuário clica no botão esquerdo do mouse.

afx_msg void OnLButtonDown(
    UINT nFlags,
    CPoint point);

Parâmetros

nFlags
[in] Indica se o usuário pressionou as teclas modificadoras. Para obter os valores possíveis, consulte o parâmetro wParam em Notificação WM_LBUTTONDOWN.

point
[in] Especifica as coordenadas x e y do ponteiro, relativas ao canto superior esquerdo da janela.

Comentários

CFrameWndEx::OnLButtonUp

A estrutura chama esse método quando o usuário libera o botão esquerdo do mouse.

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

Parâmetros

nFlags
[in] Indica se o usuário pressionou as teclas modificadoras. Para obter os valores possíveis, consulte o parâmetro wParam em Notificação WM_LBUTTONUP.

point
[in] Especifica as coordenadas x e y do ponteiro, relativas ao canto superior esquerdo da janela.

Comentários

CFrameWndEx::OnMenuButtonToolHitTest

Chamado pela estrutura quando um objeto CMFCToolBarButton processa uma mensagem WM_NCHITTEST.

virtual BOOL OnMenuButtonToolHitTest(
    CMFCToolBarButton* pButton,
    TOOLINFO* pTI);

Parâmetros

pButton
[in] Um ponteiro para o botão da barra de ferramentas.

pTI
[out] Um ponteiro para uma estrutura de informações de ferramenta.

Valor de Devolução

TRUE se o aplicativo preencher o parâmetropTI. Caso contrário, FALSE.

Comentários

Substitua esse método se você desejar fornecer informações de dica de ferramenta sobre itens de menu específicos.

CFrameWndEx::OnMenuChar

Chamado pela estrutura quando um menu é exibido e o usuário pressiona uma tecla que não corresponde a um comando.

afx_msg LRESULT OnMenuChar(
    UINT nChar,
    UINT nFlags,
    CMenu* pMenu);

Parâmetros

nChar
[in] Código de caractere da tecla pressionada.

nFlags
[in] Contém o sinalizador MF_POPUP se o menu exibido for um submenu; contém o sinalizador MF_SYSMENU se o menu exibido for um menu de controle.

pMenu
[in] Ponteiro para um menu.

Valor de Devolução

A palavra de ordem superior deve ser um dos seguintes valores.

Valor Descrição
0 A estrutura deve ignorar o pressionamento de tecla.
1 A estrutura deve fechar o menu.
2 A estrutura deve selecionar um dos itens exibidos no menu. A palavra de ordem inferior contém a ID do comando a ser selecionado.

CFrameWndEx::OnMouseMove

A estrutura chama esse método quando o ponteiro é movido.

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

Parâmetros

nFlags
[in] Indica se um usuário pressionou as teclas modificadoras. Para obter os valores possíveis, consulte o parâmetro wParam em Notificação WM_MOUSEMOVE.

point
[in] Especifica as coordenadas x e y do ponteiro, relativas ao canto superior esquerdo da janela.

Comentários

CFrameWndEx::OnMoveMiniFrame

Chamado pela estrutura quando uma janela do painel é movida.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parâmetros

pFrame
[in] Ponteiro para a janela do painel Classe CPaneFrameWnd.

Valor de Devolução

TRUE se a janela do painel não estava encaixada; FALSE se a janela do painel estava encaixada.

Comentários

CFrameWndEx::OnNcActivate

Chamado pela estrutura quando a área não cliente do quadro deve ser redesenhada para indicar uma alteração no estado ativo.

afx_msg BOOL OnNcActivate(BOOL bActive);

Parâmetros

bActive
[in] TRUE para desenhar o quadro ativo; FALSE para desenhar o quadro inativo.

Valor de Devolução

Diferente de zero para continuar com o processamento padrão; 0 para impedir que a área que não é destinada aos clientes seja desativada.

Comentários

CFrameWndEx::OnNcCalcSize

Chamado pela estrutura quando o tamanho e a posição da área do cliente devem ser calculados.

afx_msg void OnNcCalcSize(
    BOOL bCalcValidRects,
    NCCALCSIZE_PARAMS FAR* lpncsp);

Parâmetros

bCalcValidRects
[in] TRUE quando o aplicativo deve especificar uma área de cliente válida; caso contrário, FALSE.

lpncsp
[in] Ponteiro para uma estrutura NCCALCSIZE_PARAMS que contém alterações de dimensão de quadro.

Comentários

CFrameWndEx::OnNcHitTest

Chamado pela estrutura quando o ponteiro se move ou quando um botão do mouse é pressionado ou liberado.

afx_msg LRESULT OnNcHitTest(CPoint point);

Parâmetros

point
[in] O local do ponteiro nas coordenadas da tela.

Valor de Devolução

Um ponteiro atingiu um valor enumerado. Para obter uma lista de valores possíveis, consulte a Notificação WM_NCHITTEST.

Comentários

CFrameWndEx::OnNcMouseMove

Chamado pela estrutura quando o ponteiro se move em uma área não cliente.

afx_msg void OnNcMouseMove(
    UINT nHitTest,
    CPoint point);

Parâmetros

nHitTest
[in] Um ponteiro atingiu um valor enumerado. Para obter uma lista de valores possíveis, consulte a Notificação WM_NCHITTEST.

point
[in] O local do ponteiro nas coordenadas da tela.

Comentários

CFrameWndEx::OnNcPaint

Chamado pela estrutura quando a área não cliente deve ser pintada.

afx_msg void OnNcPaint();

Comentários

CFrameWndEx::OnPaneCheck

Chamado pela estrutura para controlar a visibilidade de um painel.

afx_msg BOOL OnPaneCheck(UINT nID);

Parâmetros

nID
[in] ID de controle de um painel.

Valor de Devolução

TRUE se o comando foi manipulado; FALSE para continuar com o processamento de comandos.

Comentários

CFrameWndEx::OnPostPreviewFrame

Chamado pela estrutura quando o usuário altera o modo de visualização de impressão.

afx_msg LRESULT OnPostPreviewFrame(
    WPARAM wParam,
    LPARAM lParam);

Parâmetros

wParam
[in] Esse parâmetro não é usado.

lParam
[in] TRUE quando o quadro está no modo de visualização de impressão; FALSE quando o modo de visualização de impressão está desativado.

Valor de Devolução

Sempre retorna 0.

Comentários

CFrameWndEx::OnPowerBroadcast

Chamado pela estrutura quando um evento de gerenciamento de energia ocorre.

afx_msg LRESULT OnPowerBroadcast(
    WPARAM wp,
    LPARAM lp);

Parâmetros

wp
[in] O evento de gerenciamento de energia. Para obter uma lista de valores possíveis, consulte a Mensagem WM_POWERBROADCAST.

lp
[in] Esse parâmetro não é usado.

Valor de Devolução

Resultado da chamada do procedimento de janela padrão.

Comentários

CFrameWndEx::OnSetMenu

Chamado pela estrutura para substituir o menu da janela com moldura.

afx_msg LRESULT OnSetMenu(
    WPARAM wp,
    LPARAM lp);

BOOL OnSetMenu(HMENU hmenu);

Parâmetros

wp
[in] Manipula para o novo menu da janela com moldura.

lp
[in] Manipula para o novo menu da janela.

hmenu
[in] Manipula para o novo menu da janela com moldura.

Valor de Devolução

LRESULT é o resultado da chamada do procedimento de janela padrão.

BOOL é TRUE se o evento tiver sido tratado; caso contrário, FALSE.

Comentários

CFrameWndEx::OnSetPreviewMode

Chamado pela estrutura para definir o modo de visualização de impressão para o quadro.

virtual void OnSetPreviewMode(
    BOOL bPreview,
    CPrintPreviewState* pState);

Parâmetros

bPreview
[in] TRUE para habilitar a visualização de impressão; FALSE para desabilitar a visualização de impressão.

pState
[in] Ponteiro para uma estrutura de estado com moldura CPrintPreviewState.

Comentários

CFrameWndEx::OnSetText

Chamado pela estrutura para definir o texto de uma janela.

afx_msg LRESULT OnSetText(
    WPARAM wParam,
    LPARAM lParam);

Parâmetros

wParam
[in] Esse parâmetro não é usado.

lParam
[in] Ponteiro para o texto da janela.

Valor de Devolução

Valor retornado de uma chamada para DefWindowProc.

Comentários

CFrameWndEx::OnShowCustomizePane

Chamado pela estrutura quando exibe QuickCustomizePane.

virtual BOOL OnShowCustomizePane(
    CMFCPopupMenu* pMenuPane,
    UINT uiToolbarID);

Parâmetros

pMenuPane
[in] Um ponteiro para o painel Personalizar rápido.

uiToolbarID
[in] A ID de controle da barra de ferramentas que será personalizada.

Valor de Devolução

Esse método sempre retorna TRUE.

Comentários

O menu de personalização rápida é um menu pop-up que aparece quando você clica no botão de personalização da barra de ferramentas

CFrameWndEx::OnShowPanes

Chamado pela estrutura para exibir ou ocultar painéis.

virtual BOOL OnShowPanes(BOOL bShow);

Parâmetros

bShow
[in] TRUE se o aplicativo exibir os painéis; caso contrário, FALSE.

Valor de Devolução

Esse método sempre retorna FALSE.

Comentários

A implementação padrão exibe os painéis se bShow for TRUE e os painéis estiverem ocultos ou quando bShow for FALSE e os painéis estiverem visíveis.

A implementação padrão oculta os painéis se bShow for TRUE e os painéis estiverem visíveis ou quando bShow for FALSE e os painéis estiverem ocultos.

Substitua esse método em uma classe derivada para executar código personalizado quando a estrutura exibir ou ocultar painéis.

CFrameWndEx::OnShowPopupMenu

Chamado pela estrutura quando exibe um menu pop-up.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenu);

Parâmetros

pMenu
[in] Um ponteiro para um menu pop-up.

Valor de Devolução

TRUE se o menu pop-up estiver visível; caso contrário, FALSE.

Comentários

Substitua esse método em uma classe derivada para executar código personalizado quando a estrutura exibe um menu pop-up. Por exemplo, substitua esse método para alterar a cor da tela de fundo dos comandos em um menu pop-up.

CFrameWndEx::OnSize

Chamado pela estrutura após a alteração do tamanho do quadro.

afx_msg void OnSize(
    UINT nType,
    int cx,
    int cy);

Parâmetros

nType
[in] O tipo de redimensionamento. Para obter os valores possíveis, consulte o parâmetro wParam em Notificação WM_SIZE.

cx
[in] Nova largura do quadro em pixels.

cy
[in] Nova altura do quadro em pixels.

Comentários

CFrameWndEx::OnSizing

Chamado pela estrutura quando o usuário redimensiona o quadro.

afx_msg void OnSizing(
    UINT fwSide,
    LPRECT pRect);

Parâmetros

fwSide
[in] A borda do quadro movido. Consulte o parâmetro wParam em Notificação WM_SIZING.

pRect
[in, out] Ponteiro para uma estrutura CRect ou RECT que contém as coordenadas do quadro.

Comentários

CFrameWndEx::OnSysColorChange

Chamado pela estrutura quando as cores do sistema mudam.

void OnSysColorChange();

Comentários

CFrameWndEx::OnTearOffMenu

Chamado pela estrutura quando o aplicativo exibe um menu com uma barra de desativação.

virtual BOOL OnTearOffMenu(
    CMFCPopupMenu* pMenuPopup,
    CPane* pBar);

Parâmetros

pMenuPopup
[in] Um ponteiro para um menu pop-up.

pBar
[in] Um ponteiro para uma barra destacável.

Valor de Devolução

TRUE se o menu pop-up com a barra de desativação estiver habilitado; caso contrário, FALSE.

Comentários

Substitua esse método em uma classe derivada para executar código personalizado quando a estrutura exibe uma barra de controle.

A implementação padrão não faz nada e retorna TRUE.

CFrameWndEx::OnToolbarContextMenu

Chamado pela estrutura para compilar um menu pop-up da barra de ferramentas.

afx_msg LRESULT OnToolbarContextMenu(
    WPARAM wp,
    LPARAM lp);

Parâmetros

wp
[in] Esse parâmetro não é usado.

lp
[in] Esse parâmetro não é usado.

Valor de Devolução

Sempre retorna 1.

Comentários

CFrameWndEx::OnToolbarCreateNew

A estrutura chama esse método para criar uma nova barra de ferramentas.

afx_msg LRESULT OnToolbarCreateNew(
    WPARAM wp,
    LPARAM lp);

Parâmetros

wp
[in] Esse parâmetro não é usado.

lp
[in] Ponteiro para o texto da barra de título da barra de ferramentas.

Valor de Devolução

Ponteiro para a nova barra de ferramentas; ou NULL se uma barra de ferramentas não foi criada.

Comentários

CFrameWndEx::OnToolbarDelete

Chamado pela estrutura quando uma barra de ferramentas é excluída.

afx_msg LRESULT OnToolbarDelete(
    WPARAM /* unused */,
    LPARAM lp);

Parâmetros

unused
[in] Esse parâmetro não é usado.

lp
[in] Ponteiro para uma barra de ferramentas.

Valor de Devolução

TRUE se a barra de ferramentas tiver sido excluída; caso contrário, FALSE.

Comentários

CFrameWndEx::OnUpdateFrameMenu

Chamado pela estrutura para definir o menu de quadros.

virtual void OnUpdateFrameMenu(HMENU hMenuAlt);

Parâmetros

hMenuAlt
[in] Manipule para um menu alternativo.

Comentários

CFrameWndEx::OnUpdateFrameTitle

A estrutura chama esse método para atualizar a barra de título da janela com moldura.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Parâmetros

bAddToTitle
[in] TRUE para adicionar o título do documento ativo à barra de título da janela com moldura; caso contrário, FALSE.

Comentários

CFrameWndEx::OnUpdatePaneMenu

Chamado pela estrutura para atualizar o menu do painel.

afx_msg void OnUpdatePaneMenu(CCmdUI* pCmdUI);

Parâmetros

pCmdUI
[in] Ponteiro para o objeto da interface do usuário do painel.

Comentários

CFrameWndEx::OnWindowPosChanged

Chamado pela estrutura quando o tamanho do quadro, a posição ou a ordem em z foram alterados devido a uma chamada para um método de gerenciamento de janela.

afx_msg void OnWindowPosChanged(WINDOWPOS FAR* lpwndpos);

Parâmetros

lpwndpos
[in] Ponteiro para uma estrutura WINDOWPOS que contém o novo tamanho e a posição.

Comentários

CFrameWndEx::PaneFromPoint

Pesquisa cada painel em busca do ponto determinado.

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar,
    CRuntimeClass* pRTCBarType) const;

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    DWORD& dwAlignment,
    CRuntimeClass* pRTCBarType) const;

Parâmetros

point
[in] As coordenadas da tela do ponto a ser verificado.

nSensitivity
[in] Expanda o retângulo delimitador de cada barra de controle por esse valor ao procurar pelo ponto.

bExactBar
[in] TRUE para ignorar o parâmetro nSensitivity; caso contrário, FALSE.

pRTCBarType
[in] Se não for NULL, o método pesquisará apenas as barras de controle do tipo especificado.

dwAlignment
[out] Se tiver êxito, esse parâmetro conterá o lado da barra de controle mais próxima do ponto especificado. Caso contrário, esse parâmetro não é inicializado.

Valor de Devolução

Um ponteiro para uma barra de controle que contém o point; NULL se nenhum controle for encontrado.

Comentários

Esse método pesquisa todas as barras de controle em seu aplicativo para obter point.

Use nSensitivity para aumentar o tamanho da área de pesquisa. Use pRTCBarType para restringir os tipos de barras de controle pesquisados pelo método.

CFrameWndEx::PreTranslateMessage

Identifica mensagens de janela específicas antes de serem enviadas.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parâmetros

pMsg
[in] Um ponteiro para uma estrutura MSG que contém a mensagem a ser processada.

Valor de Devolução

Diferente de zero se a mensagem foi manipulada e não deve ser expedida; 0 se a mensagem não foi manipulada e deve ser expedida.

Comentários

CFrameWndEx::RecalcLayout

Ajusta o layout do quadro e as janelas filho.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parâmetros

bNotify
[in] Especifica se o item do cliente OLE deve ser notificado sobre a alteração do layout.

Comentários

Esse método é chamado quando o tamanho da janela com moldura é alterado ou quando as barras de controle são exibidas ou ocultas.

CFrameWndEx::RemovePaneFromDockManager

Cancela o registro de um painel e o remove do gerenciador de encaixe.

void RemovePaneFromDockManager(
    CBasePane* pControlBar,
    BOOL bDestroy,
    BOOL bAdjustLayout,
    BOOL bAutoHide,
    CBasePane* pBarReplacement);

Parâmetros

pControlBar
[in] Um ponteiro para o painel da barra de controle a ser removido.

bDestroy
[in] TRUE para destruir a barra de controle depois de removê-la; caso contrário, FALSE.

bAdjustLayout
[in] TRUE para ajustar o layout do encaixe; caso contrário, FALSE.

bAutoHide
[in] TRUE se a barra de controle estiver no modo de ocultação automática; caso contrário, FALSE.

pBarReplacement
[in] Um ponteiro para um painel que substitui o painel removido.

Comentários

Use este método para remover uma barra de controle do layout de encaixe da janela com moldura.

A Classe CDockingManager manipula o layout das barras de controle. Você deve registrar cada barra de controle com o gerenciador de encaixe usando o método CFrameWndEx::AddPane ou CFrameWndEx::InsertPane.

CFrameWndEx::SetDockState

Restaura o layout de encaixe para o estado de encaixe armazenado no registro.

void SetDockState(const CDockState& state);

Parâmetros

state
O estado do encaixe. Este parâmetro é ignorado.

CFrameWndEx::SetPrintPreviewFrame

Define a janela com moldura de visualização de impressão.

void SetPrintPreviewFrame(CFrameWnd* pWnd);

Parâmetros

pWnd
[in] Ponteiro para uma janela com moldura de visualização de impressão.

Comentários

CFrameWndEx::SetupToolbarMenu

Insere comandos definidos pelo usuário em um menu da barra de ferramentas.

void SetupToolbarMenu(
    CMenu& menu,
    const UINT uiViewUserToolbarCmdFirst,
    const UINT uiViewUserToolbarCmdLast);

Parâmetros

menu
[in] Um objeto CMenu a ser modificado.

uiViewUserToolbarCmdFirst
[in] O primeiro comando definido pelo usuário.

uiViewUserToolbarCmdLast
[in] O último comando definido pelo usuário.

Comentários

A estrutura armazena os comandos definidos pelo usuário em uma lista. Use uiViewUserToolbarCmdFirst e uiViewUserToolbarCmdList para especificar os índices dos comandos a serem inseridos.

CFrameWndEx::ShowFullScreen

Alterna o quadro principal entre o modo de tela inteira e o modo normal.

void ShowFullScreen();

CFrameWndEx::ShowPane

Mostra ou oculta o painel especificado.

void ShowPane(
    CBasePane* pBar,
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Parâmetros

pBar
[in] Um ponteiro para a barra de controle para ser exibida ou oculta.

bShow
[in] Se TRUE, o aplicativo exibe a barra de controle. Caso contrário, o aplicativo oculta a barra de controle.

bDelay
[in] Se TRUE, atrase o ajuste do layout de encaixe até que a estrutura chame CFrameWndEx::AdjustDockingLayout. Caso contrário, recalcule o layout de encaixe imediatamente.

bActivate
[in] Se TRUE, torne a barra de controle ativa. Caso contrário, exiba a barra de controle em um estado inativo.

CFrameWndEx::UpdateCaption

Chamado pela estrutura para atualizar a legenda do quadro de janela.

void UpdateCaption();

Comentários

CFrameWndEx::WinHelp

Invoca o aplicativo WinHelp ou a ajuda relacionada ao contexto.

virtual void WinHelp(
    DWORD dwData,
    UINT nCmd = HELP_CONTEXT);

Parâmetros

dwData
Dados que dependem do parâmetro nCmd. Para obter uma lista de valores possíveis, consulte WinHelp.

nCmd
O comando Ajuda. Para obter uma lista de valores possíveis, consulte WinHelp.

Comentários

Confira também

Gráfico da hierarquia
Classes
CFrameWnd