Partilhar via

CFrameWndEx Classe

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Implementa a funcionalidade de uma interface de documento único (SDI) do Windows com uma janela sobreposta ou de frames popup, e fornece membros para gerir a janela. Prolonga a CFrameWnd turma.

Sintaxe

class CFrameWndEx : public CFrameWnd

Membros

Métodos Públicos

Nome Description
CFrameWndEx::ActiveItemRecalcLayout Ajusta a disposição do item cliente OLE e a área do cliente da moldura.
CFrameWndEx::AddDockSite Este método não é utilizado.
CFrameWndEx::AddPane Regista uma barra de controlo junto do gestor de acoplamento.
CFrameWndEx::AdjustDockingLayout Recalcula a disposição de todos os vidros que estão acoplados à janela da moldura.
CFrameWndEx::DelayUpdateFrameMenu Define o menu de frames e depois atualiza-o quando o processamento de comandos está inativo.
CFrameWndEx::DockPane Acopla o painel especificado à janela da moldura.
CFrameWndEx::DockPaneLeftOf Atraca um painel à esquerda de outro vidro.
CFrameWndEx::EnableAutoHidePanes Ativa o modo de ocultação automática dos painéis quando estão acoplados aos lados especificados da janela principal do frame.
CFrameWndEx::EnableDocking Permite o acoplamento dos painéis que pertencem à janela da moldura.
CFrameWndEx::EnableFullScreenMainMenu Mostra ou esconde o menu principal em modo de ecrã completo.
CFrameWndEx::EnableFullScreenMode Ativa o modo de ecrã inteiro para a janela de frames.
CFrameWndEx::EnableLoadDockState Ativa ou desativa o carregamento do estado de acoplamento.
CFrameWndEx::EnablePaneMenu Ativa ou desativa o tratamento automático do menu do painel.
CFrameWndEx::GetActivePopup Devolve um apontador para o menu pop-up atualmente exibido.
CFrameWndEx::GetDefaultResId Devolve o ID de recurso que especificaste quando o framework carregou a janela de frame.
CFrameWndEx::GetDockingManager Recupera o CDockingManager objeto Class para a janela de moldura.
CFrameWndEx::GetMenuBar Devolve um ponteiro para o objeto da barra de menu ligado à janela do enquadramento.
CFrameWndEx::GetPane Devolve um ponteiro para o painel com o ID especificado.
CFrameWndEx::GetRibbonBar Recupera o controlo da barra de fita para a estrutura.
CFrameWndEx::GetTearOffBars Devolve uma lista de objetos do painel que estão em estado de remoção.
CFrameWndEx::GetToolbarButtonToolTipText É chamado pela framework quando a aplicação mostra a dica de ferramenta para um botão da barra de ferramentas.
CFrameWndEx::InsertPane Regista um painel junto do gestor de docking.
CFrameWndEx::IsFullScreen Determina se a janela do frame está em modo de ecrã completo.
CFrameWndEx::IsMenuBarAvailable Determina se o ponteiro para o objeto da barra de menu é válido.
CFrameWndEx::IsPointNearDockSite Indica se o ponto está localizado numa zona de alinhamento.
CFrameWndEx::IsPrintPreview Indica se a janela de frames está em modo de visualização de impressão.
CFrameWndEx::LoadFrame Este método é chamado após a construção para criar a janela de estrutura e carregar os seus recursos.
CFrameWndEx::NegotiateBorderSpace Implementa a negociação fronteiriça com o cliente do OLE.
CFrameWndEx::OnActivate A estrutura chama este método quando a entrada do utilizador é comutada para ou para fora da frame.
CFrameWndEx::OnActivateApp Chamada pelo framework quando a aplicação é selecionada ou desselecionada.
CFrameWndEx::OnChangeVisualManager É chamado pelo framework quando uma alteração no frame requer uma alteração no gestor visual.
CFrameWndEx::OnClose A estrutura chama este método para fechar a fotograma.
CFrameWndEx::OnCloseDockingPane É chamado pelo framework quando o utilizador clica no botão Fechar num painel de acoplamento.
CFrameWndEx::OnCloseMiniFrame É chamado pela framework quando o utilizador clica no botão Fechar numa janela de mini frame flutuante.
CFrameWndEx::OnClosePopupMenu É chamado pelo framework quando um menu pop-up ativo processa uma WM_DESTROY mensagem.
CFrameWndEx::OnCmdMsg Envia mensagens de comando.
CFrameWndEx::OnContextHelp Chamado pelo framework para mostrar ajuda relacionada com o contexto.
CFrameWndEx::OnCreate Chamado pelo framework depois de o frame ser criado.
CFrameWndEx::OnDestroy Chamada pela estrutura quando a estrutura é destruída.
CFrameWndEx::OnDrawMenuImage Chamada pelo framework quando a aplicação desenha a imagem associada a um item do menu.
CFrameWndEx::OnDrawMenuLogo Chamado pelo framework quando um CMFCPopupMenu objeto processa uma WM_PAINT mensagem.
CFrameWndEx::OnDWMCompositionChanged Chamada pelo framework quando a composição do Gestor de Janelas do Ambiente de Trabalho (DWM) está ativada ou desativada.
CFrameWndEx::OnExitSizeMove Chamada pela estrutura quando a estrutura deixa de se mover ou de redimensionar.
CFrameWndEx::OnGetMinMaxInfo Chamada pela estrutura quando a estrutura é redimensionada para definir limites de dimensão da janela.
CFrameWndEx::OnIdleUpdateCmdUI Chamado pela framework para atualizar a visualização de frames quando o processamento de comandos está inativo.
CFrameWndEx::OnLButtonDown O framework chama este método quando o utilizador pressiona o botão esquerdo do rato.
CFrameWndEx::OnLButtonUp A estrutura chama este método quando o utilizador solta o botão esquerdo do rato.
CFrameWndEx::OnMenuButtonToolHitTest Chamado pelo framework quando um CMFCToolBarButton objeto processa uma WM_NCHITTEST mensagem.
CFrameWndEx::OnMenuChar É chamado pelo framework quando um menu é exibido e o utilizador pressiona uma tecla que não corresponde a um comando.
CFrameWndEx::OnMouseMove A estrutura chama este método quando o ponteiro se move.
CFrameWndEx::OnMoveMiniFrame Chamada pela estrutura quando uma janela de painel se move.
CFrameWndEx::OnNcActivate Chamada pela estrutura quando a área não cliente da trama 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 Chamada pela estrutura quando o ponteiro se move ou quando um botão do rato é pressionado ou libertado.
CFrameWndEx::OnNcMouseMove Chamado pela framework quando o ponteiro se move numa área não cliente.
CFrameWndEx::OnNcPaint Chamado pela estrutura quando a área não-cliente tem de ser pintada.
CFrameWndEx::OnPaneCheck Chamado pela estrutura para controlar a visibilidade de um painel.
CFrameWndEx::OnPostPreviewFrame É chamado pelo framework quando o utilizador alterou o modo de pré-visualização de impressão.
CFrameWndEx::OnPowerBroadcast É chamado pelo framework quando ocorre um evento de gestão de energia.
CFrameWndEx::OnSetMenu Chamado pela estrutura para substituir o menu da janela da moldura.
CFrameWndEx::OnSetPreviewMode Chamado pelo framework para definir o modo de pré-visualização de impressão para o frame.
CFrameWndEx::OnSetText Chamado pelo framework para definir o texto de uma janela.
CFrameWndEx::OnShowCustomizePane É chamado pelo framework quando um painel de personalização rápida está ativado.
CFrameWndEx::OnShowPanes Chamado pelo framework para mostrar ou ocultar painéis.
CFrameWndEx::OnShowPopupMenu É chamado pelo framework quando um menu pop-up está ativado.
CFrameWndEx::OnSize A estrutura chama este método após o tamanho da moldura mudar.
CFrameWndEx::OnSizing O framework chama este método quando o utilizador redimensiona o frame.
CFrameWndEx::OnSysColorChange Chamado pela estrutura quando as cores do sistema mudam.
CFrameWndEx::OnTearOffMenu É chamado pelo framework quando um menu com barra de remoção está ativado.
CFrameWndEx::OnToolbarContextMenu Chamado pela framework para construir um menu contextual na barra de ferramentas.
CFrameWndEx::OnToolbarCreateNew A estrutura chama este método para criar uma nova barra de ferramentas.
CFrameWndEx::OnToolbarDelete Chamada pela framework quando uma barra de ferramentas é eliminada.
CFrameWndEx::OnUpdateFrameMenu Chamado pelo framework para definir o menu de frames.
CFrameWndEx::OnUpdateFrameTitle O framework chama este método para atualizar a barra de título da janela do frame.
CFrameWndEx::OnUpdatePaneMenu Chamado pelo framework para atualizar o menu de painéis.
CFrameWndEx::OnWindowPosChanged Chamada pela framework quando o tamanho, posição ou ordem z do frame mudou devido a uma chamada a um método de gestão de janelas.
CFrameWndEx::PaneFromPoint Devolve o painel de acoplamento que contém o ponto especificado.
CFrameWndEx::PreTranslateMessage Trata de mensagens específicas de janelas antes de serem enviadas.
CFrameWndEx::RecalcLayout Ajusta a disposição da moldura e das suas janelas filhas.
CFrameWndEx::RemovePaneFromDockManager Desregista um painel e remove-o da lista interna no gestor de docking.
CFrameWndEx::SetDockState Restaura o layout de acoplamento para o estado armazenado no registo.
CFrameWndEx::SetPrintPreviewFrame Define a janela de pré-visualização do frame de impressão.
CFrameWndEx::SetupToolbarMenu Insere comandos definidos pelo utilizador num menu da barra de ferramentas.
CFrameWndEx::ShowFullScreen Alterna o frame principal entre o modo ecrã completo e o modo normal.
CFrameWndEx::ShowPane Mostra ou esconde o painel especificado.
CFrameWndEx::UpdateCaption Chamado pelo framework para atualizar a legenda da moldura da janela.
CFrameWndEx::WinHelp Invoca a WinHelp aplicação ou ajuda relacionada com o contexto.

Example

O exemplo seguinte demonstra como herdar uma classe dessa CFrameWndEx classe. O exemplo ilustra as assinaturas do método na subclasse e como sobrepor o OnShowPopupMenu método. Este excerto 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

Requerimentos

Cabeçalho:afxframewndex.h

CFrameWndEx::ActiveItemRecalcLayout

Ajusta a disposição do item cliente OLE e a área do cliente da moldura.

void ActiveItemRecalcLayout();

Observações

CFrameWndEx::AddPane

Regista uma barra de controlo junto do gestor de acoplamento.

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

Parâmetros

pControlBar
[dentro] Um painel de controlo para registar.

bTail
[dentro] TRUE Se quiseres adicionar o painel da barra de controlo no final da lista; FALSE caso contrário.

Valor de retorno

TRUE se a barra de controlo fosse registada com sucesso; FALSE caso contrário.

CFrameWndEx::AdjustDockingLayout

Recalcula a disposição de todos os vidros que estão acoplados à janela da moldura.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Parâmetros

hdwp
Uma pega para uma estrutura que contém as posições de múltiplas janelas. .

Observações

A estrutura hdwp é inicializada pelo BeginDeferWindowPos método.

CFrameWndEx::DelayUpdateFrameMenu

Define o menu de frames e depois atualiza-o quando o processamento de comandos está inativo.

virtual void DelayUpdateFrameMenu(HMENU hMenuAlt);

Parâmetros

hMenuAlt
[dentro] Utilize um menu alternativo.

Observações

CFrameWndEx::DockPane

Acopla o painel especificado à janela da moldura.

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

Parâmetros

pBar
[dentro] Um apontador para a barra de controlo a acoplar.

nDockBarID
[dentro] O ID do lado da janela da moldura para acoplar.

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

Observações

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

  • AFX_IDW_DOCKBAR_TOP

  • AFX_IDW_DOCKBAR_BOTTOM

  • AFX_IDW_DOCKBAR_LEFT

  • AFX_IDW_DOCKBAR_RIGHT

CFrameWndEx::DockPaneLeftOf

Acopla o painel especificado à esquerda de outro painel.

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

Parâmetros

pBar
[dentro] Um apontador para o objeto do painel a ser acoplado.

pLeftOf
[dentro] Um apontador para o painel à esquerda do qual se deve acoplar o painel especificado por pBar.

Valor de retorno

TRUE se pBar for acoplado com sucesso. FALSE caso contrário.

Observações

O método pega na barra de ferramentas especificada pelo pBar parâmetro e acopla-a no lado esquerdo da barra de ferramentas especificado por pLeftOf parâmetro.

CFrameWndEx::EnableAutoHidePanes

Ativa o modo de ocultação automática para o painel quando está acoplado ao lado especificado da janela principal do frame.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parâmetros

dwDockStyle
[dentro] Especifica o lado da janela principal onde deve acoplar o painel.

Valor de retorno

TRUE se um painel de barra for encaixado com sucesso no lado da janela da moldura, especificado por dwDockStyle, FALSE caso contrário.

Observações

dwDockStyle pode ter um dos seguintes valores:

  • CBRS_ALIGN_TOP: permite que a barra de controlo seja acoplada ao topo da área do cliente de uma janela de frame.

  • CBRS_ALIGN_BOTTOM: permite que a barra de controlo seja acoplada ao fundo da área do cliente de uma janela de frame.

  • CBRS_ALIGN_LEFT: permite que a barra de controlo seja acoplada ao lado esquerdo da área do cliente de uma janela de frame.

  • CBRS_ALIGN_RIGHT: permite que a barra de controlo seja acoplada ao lado direito da área cliente de uma janela de frame.

CFrameWndEx::EnableDocking

Permite acoplar os vidros da janela da moldura.

BOOL EnableDocking(DWORD dwDockStyle);

Parâmetros

dwDockStyle
[dentro] Especifica o lado da janela principal onde a barra de vidros encaixa.

Valor de retorno

TRUE se um painel de barra puder ser acoplado com sucesso no lado especificado. FALSE caso contrário.

Observações

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

  • CBRS_ALIGN_TOP

  • CBRS_ALIGN_BOTTOM

  • CBRS_ALIGN_LEFT

  • CBRS_ALIGN_RIGHT

CFrameWndEx::EnableFullScreenMainMenu

Mostra ou esconde o menu principal em modo de ecrã completo.

void EnableFullScreenMainMenu(BOOL bEnableMenu);

Parâmetros

bEnableMenu
[dentro] TRUE para mostrar o menu principal em modo de ecrã completo, FALSE caso contrário.

CFrameWndEx::EnableFullScreenMode

Ativa o modo de ecrã inteiro para a janela do frame.

void EnableFullScreenMode(UINT uiFullScreenCmd);

Parâmetros

uiFullScreenCmd
[dentro] O ID de um comando que ativa e desativa o modo de ecrã inteiro.

Observações

No modo de ecrã inteiro, todas as barras de controlo de acoplamento, barras de ferramentas e menus ficam ocultos e a vista ativa é redimensionada para ocupar o ecrã inteiro.

Ao ativar o modo de ecrã inteiro, deve especificar um ID do comando que ativa ou desativa o modo de ecrã inteiro. Podes chamar EnableFullScreenMode a partir da função do OnCreate mainframe. Quando uma janela de frame está a ser alterada para um modo de ecrã completo, a estrutura cria uma barra de ferramentas flutuante com um botão que tem o ID de comando especificado.

Se quiseres manter o menu principal no ecrã, liga CFrameWndEx::EnableFullScreenMainMenupara .

CFrameWndEx::EnableLoadDockState

Ativa ou desativa o carregamento do estado de acoplamento.

void EnableLoadDockState(BOOL bEnable=TRUE);

Parâmetros

bEnable
[dentro] TRUE para permitir o carregamento do estado de acoplamento, FALSE para desativar o carregamento do estado de acoplamento.

CFrameWndEx::EnablePaneMenu

Ativa ou desativa o tratamento automático do menu do painel.

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

Parâmetros

bEnable
[dentro] TRUE para permitir a manipulação automática dos menus pop-up da barra de controlo; FALSE para desativar a manipulação automática dos menus pop-up da barra de controlo.

uiCustomizeCmd
[dentro] O ID do comando do item do menu Personalizar .

strCustomizeLabel
[dentro] A etiqueta a ser exibida para o item do menu Personalizar

uiViewToolbarsMenuEntryID
[dentro] O ID de um elemento do menu da barra de ferramentas que abre o menu pop-up na barra de controlo.

bContextMenuShowsToolbarsOnly
[dentro] Se TRUE, o menu contextual da barra de controlo mostra apenas a lista de barras de ferramentas. Se FALSE, o menu mostra a lista das barras de ferramentas e das barras de acoplamento.

bViewMenuShowsToolbarsOnly
[dentro] Se TRUE, o menu da barra de controlo mostra apenas a lista das barras de ferramentas. Se FALSE, o menu mostra a lista das barras de ferramentas e das barras de acoplamento.

CFrameWndEx::GetActivePopup

Devolve um apontador para o menu pop-up atualmente exibido.

CMFCPopupMenu* GetActivePopup() const;

Valor de retorno

Um apontador para o menu pop-up atualmente exibido; caso contrário NULL.

CFrameWndEx::GetDefaultResId

Devolve o ID de recurso que especificaste quando o framework carregou a janela de frame.

UINT GetDefaultResId() const;

Valor de retorno

O valor do ID de recurso que o utilizador especificou quando o framework carregou a janela de frame. Zero se a janela do quadro não tiver barra de menus.

CFrameWndEx::GetDockingManager

Recupera o CDockingManager objeto Class para a janela de moldura.

CDockingManager* GetDockingManager();

Valor de retorno

Um aponto para a CDockingManager Aula.

Observações

A janela de frame cria e utiliza um CDockingManager objeto Class para gerir o docking da janela filha.

CFrameWndEx::GetMenuBar

Devolve um ponteiro para o objeto da barra de menu ligado à janela do enquadramento.

const CMFCMenuBar* GetMenuBar() const;

Valor de retorno

Um apontador para o objeto da barra de menus ligado à janela da moldura.

CFrameWndEx::GetPane

Devolve um ponteiro para o painel com o ID especificado.

CBasePane* GetPane(UINT nID);

Parâmetros

nID
[dentro] O ID de controlo.

Valor de retorno

Um apontador para o painel que tem o ID especificado. NULL se tal painel não existir.

CFrameWndEx::GetRibbonBar

Recupera o controlo da barra de fita para a estrutura.

CMFCRibbonBar* GetRibbonBar();

Valor de retorno

Aponta para a CMFCRibbonBar Classe da moldura.

Observações

CFrameWndEx::GetTearOffBars

Devolve uma lista de objetos do painel que estão em estado de remoção.

const CObList& GetTearOffBars() const;

Valor de retorno

Uma referência a CObList um objeto que contém uma coleção de apontadores para os objetos do painel que estão em estado de separação.

CFrameWndEx::GetToolbarButtonToolTipText

É chamado pela framework quando a aplicação mostra a dica de ferramenta para um botão da barra de ferramentas.

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

Parâmetros

pButton
[dentro] Um apontador para um botão da barra de ferramentas.

strTTText
[dentro] O texto da dica de ferramenta para mostrar o botão.

Valor de retorno

TRUE se a dica de ferramenta já foi apresentada. FALSE caso contrário.

Observações

Por defeito, este método não faz nada. Anule este método se quiser mostrar a dica de ferramenta do botão da barra de ferramentas.

CFrameWndEx::InsertPane

Insere um painel numa lista de barras de controlo e regista-o junto do gestor de docking.

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

Parâmetros

pControlBar
Um apontador para uma barra de controlo a ser inserido na lista de barras de controlo e registado no gestor de acoplamento.

pTarget
Um ponteiro para uma barra de controlo antes ou depois do qual inserir o painel.

bAfter
TRUE Se quiseres inserir pControlBar depois pTargetde , FALSE caso contrário.

Valor de retorno

TRUE se a barra de controlo foi inserida e registada com sucesso, FALSE caso contrário.

Observações

Deves registar cada barra de controlo usando a CDockingManager Classe para participar no layout do docking.

CFrameWndEx::IsFullScreen

Determina se a janela do frame está em modo de ecrã completo.

BOOL IsFullScreen() const;

Valor de retorno

TRUE se a janela do enquadramento estiver em modo de ecrã completo; caso contrário FALSE.

Observações

Podes definir o modo de ecrã inteiro chamando o CFrameWndEx::EnableFullScreenMode método.

CFrameWndEx::IsMenuBarAvailable

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

BOOL IsMenuBarAvailable() const;

Valor de retorno

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

CFrameWndEx::IsPointNearDockSite

Determina se o ponto está localizado numa zona de alinhamento.

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

Parâmetros

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

dwBarAlignment
[fora] Onde o ponto está alinhado. Consulte a tabela na secção de Observações para possíveis valores.

bOuterEdge
[fora] TRUE se o ponto estiver localizado perto da fronteira do quadro; FALSE Se o ponto estiver localizado numa área de cliente.

Valor de retorno

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

Observações

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

Valor Description
CBRS_ALIGN_TOP Alinhado com o topo.
CBRS_ALIGN_RIGHT Alinhado à direita.
CBRS_ALIGN_BOTTOM Alinhado com a parte inferior.
CBRS_ALIGN_LEFT Alinhado à esquerda.

CFrameWndEx::IsPrintPreview

Determina se a janela de frames está em modo de visualização de impressão.

BOOL IsPrintPreview();

Valor de retorno

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

Observações

CFrameWndEx::LoadFrame

Este método é chamado após a construção para criar a janela de estrutura e carregar os seus recursos.

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

Parâmetros

nIDResource
[dentro] O ID do recurso que é usado para carregar todos os recursos do frame.

dwDefaultStyle
[dentro] O estilo padrão da janela de moldura.

pParentWnd
[dentro] Apontar para a janela principal da moldura.

pContext
[dentro] Apontador para uma CCreateContext classe Structure que é usada pelo framework durante a criação da aplicação.

Valor de retorno

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

Observações

CFrameWndEx::NegotiateBorderSpace

Implementa a negociação fronteiriça com o cliente do OLE.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Parâmetros

nBorderCmd
[dentro] O comando de negociação fronteiriça. Consulte a secção de Observações para possíveis valores.

lpRectBorder
[inspira, expira] Dimensões da fronteira.

Valor de retorno

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

Observações

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

borderGet
Obtenha espaço disponível para o cliente do OLE.

borderRequest
Solicitar espaço cliente OLE.

borderSet
Defina o espaço do cliente OLE.

CFrameWndEx::OnActivate

A estrutura chama este método quando a entrada do utilizador é comutada para ou para fora da frame.

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

Parâmetros

nState
[dentro] Se o frame está ativo ou inativo. Consulte a tabela na secção de Observações para possíveis valores.

pWndOther
[dentro] Apontar para outra janela que está a trocar a entrada do utilizador com a atual.

bMinimized
[dentro] O estado minimizado do enquadramento. TRUE se o referencial for minimizado; caso contrário, FALSE.

Observações

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

Valor Description
WA_ACTIVE A moldura é selecionada por um método diferente do clique do rato.
WA_CLICKACTIVE A moldura é selecionada por um clique do rato.
WA_INACTIVE A moldura não está selecionada.

CFrameWndEx::OnActivateApp

Chamada pelo framework quando a aplicação é selecionada ou desselecionada.

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

Parâmetros

bActive
[dentro] TRUE se a candidatura for selecionada; FALSE Se a candidatura não for selecionada.

dwThreadID
[dentro] Este parâmetro não é usado.

Observações

CFrameWndEx::OnChangeVisualManager

É chamado pelo framework quando uma alteração no frame requer uma alteração no gestor visual.

afx_msg LRESULT OnChangeVisualManager(
    WPARAM wParam,
    LPARAM lParam);

Parâmetros

wParam
[dentro] Este parâmetro não é usado.

lParam
[dentro] Este parâmetro não é usado.

Valor de retorno

Sempre devolve 0.

Observações

CFrameWndEx::OnClose

A estrutura chama este método para fechar a fotograma.

afx_msg void OnClose();

Observações

Se o frame estiver em modo de pré-visualização de impressão, envia uma mensagem do Windows para fechar a pré-visualização de impressão; caso contrário, se o quadro hospedar um cliente OLE, o cliente é desativado.

CFrameWndEx::OnCloseDockingPane

É chamado pelo framework quando o utilizador clica no botão Fechar num painel de acoplamento.

virtual BOOL OnCloseDockingPane(CDockablePane* pPane);

Valor de retorno

TRUE Se a barra de acoplagem puder ser fechada. FALSE contrário

Observações

O implemento padrão não faz nada. Anula este método se quiseres lidar com o esconderijo da barra de acoplamento.

CFrameWndEx::OnCloseMiniFrame

É chamado pela framework quando o utilizador clica no botão Fechar numa janela de mini frame flutuante.

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd* pWnd);

Valor de retorno

TRUE se uma janela de moldura mini flutuante puder ser fechada. FALSE caso contrário.

Observações

A implementação padrão não faz nada. Anule este método se quiser processar a ocultação de uma janela de mini frame flutuante.

CFrameWndEx::OnClosePopupMenu

É chamado pelo framework quando um menu pop-up ativo processa uma WM_DESTROY mensagem.

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

Parâmetros

pMenuPopup
Um apontador para um menu pop-up.

Observações

O framework envia uma WM_DESTROY mensagem quando está prestes a fechar a janela. Substitua este método se quiser lidar com notificações de CMFCPopupMenu objetos que pertencem à janela do frame quando um CMFCPopupMenu objeto estiver a processar uma WM_DESTROY mensagem enviada pelo framework quando a janela está a ser fechada.

CFrameWndEx::OnCmdMsg

Envia mensagens de comando.

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

Parâmetros

nID
[dentro] O ID do comando.

nCode
[dentro] Categoria de mensagem de comando.

pExtra
[inspira, expira] Apontar para um objeto de comando.

pHandlerInfo
[inspira, expira] Apontador para uma estrutura de handler de comandos.

Valor de retorno

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

Observações

CFrameWndEx::OnContextHelp

Chamado pelo framework para mostrar ajuda relacionada com o contexto.

afx_msg void OnContextHelp();

Observações

CFrameWndEx::OnCreate

Chamado pelo framework depois de o frame ser criado.

afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

Parâmetros

lpCreateStruct
[dentro] Um apontador para a CREATESTRUCT Estrutura do novo quadro.

Valor de retorno

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

Observações

CFrameWndEx::OnDestroy

Chamada pela estrutura quando a estrutura é destruída.

afx_msg void OnDestroy();

Observações

A mesa aceleradora e todas as janelas estão destruídas.

CFrameWndEx::OnDrawMenuImage

Chamada pelo framework quando a aplicação desenha a imagem associada a um item do menu.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pMenuButton
[dentro] Um apontador para um botão de menu cuja imagem está a ser renderizada.

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

Valor de retorno

TRUE se o framework renderizar a imagem com sucesso; FALSE caso contrário.

Observações

Substitua este método se quiser personalizar a renderização da imagem para os itens do menu que pertencem à barra de menu pertencente ao CFrameWndEx objeto derivado.

Chamado pelo framework quando um CMFCPopupMenu objeto processa uma WM_PAINT mensagem.

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

pMenu
[dentro] Um indicador para o item do menu.

rectLogo
[dentro] Uma referência a uma estrutura constante CRect que especifica a posição e o tamanho do ecrã do logótipo do menu.

Observações

Substitua esta função se quiser mostrar um logótipo no menu pop-up que pertença à barra de menu pertencente ao CFrameWndEx objeto derivado.

CFrameWndEx::OnDWMCompositionChanged

Chamada pelo framework quando a composição do Gestor de Janelas do Ambiente de Trabalho (DWM) está ativada ou desativada.

afx_msg LRESULT OnDWMCompositionChanged(
    WPARAM wp,
    LPARAM lp);

Parâmetros

wp
[dentro] Este parâmetro não é usado.

lp
[dentro] Este parâmetro não é usado.

Valor de retorno

Sempre devolve 0.

Observações

CFrameWndEx::OnExitSizeMove

Chamada pela estrutura quando a estrutura deixa de se mover ou de redimensionar.

LRESULT OnExitSizeMove(
    WPARAM wp,
    LPARAM lp);

Parâmetros

wp
[dentro] Este parâmetro não é usado.

lp
[dentro] Este parâmetro não é usado.

Valor de retorno

Sempre devolve 0.

Observações

CFrameWndEx::OnGetMinMaxInfo

Chamada pela estrutura quando a estrutura é redimensionada para definir limites de dimensão da janela.

afx_msg void OnGetMinMaxInfo(MINMAXINFO FAR* lpMMI);

Parâmetros

lpMMI
[dentro] Aponta para uma MINMAXINFO estrutura.

Observações

CFrameWndEx::OnIdleUpdateCmdUI

Chamado pela framework para atualizar a visualização de frames quando o processamento de comandos está inativo.

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

Parâmetros

wParam
[dentro] Este parâmetro não é usado.

lParam
[dentro] Este parâmetro não é usado.

Valor de retorno

Sempre devolve 0.

Observações

CFrameWndEx::OnLButtonDown

O framework chama este método quando o utilizador pressiona o botão esquerdo do rato.

afx_msg void OnLButtonDown(
    UINT nFlags,
    CPoint point);

Parâmetros

nFlags
[dentro] Indica se o utilizador pressionou as teclas modificadoras. Para valores possíveis, consulte o parâmetro wParam em WM_LBUTTONDOWN Notificação.

point
[dentro] Especifica as coordenadas x e y do apontador, relativamente ao canto superior esquerdo da janela.

Observações

CFrameWndEx::OnLButtonUp

A estrutura chama este método quando o utilizador solta o botão esquerdo do rato.

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

Parâmetros

nFlags
[dentro] Indica se o utilizador pressionou as teclas modificadoras. Para valores possíveis, consulte o parâmetro wParam em WM_LBUTTONUP Notificação.

point
[dentro] Especifica as coordenadas x e y do apontador, relativamente ao canto superior esquerdo da janela.

Observações

CFrameWndEx::OnMenuButtonToolHitTest

Chamado pelo framework quando um CMFCToolBarButton objeto processa uma WM_NCHITTEST mensagem.

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

Parâmetros

pButton
[dentro] Um apontador para o botão da barra de ferramentas.

pTI
[fora] Um apontador para uma estrutura de informação de ferramenta.

Valor de retorno

TRUE se a aplicação preencher o pTI parâmetro. FALSE caso contrário.

Observações

Anule este método se quiser fornecer uma dica de informação sobre um item específico do menu.

CFrameWndEx::OnMenuChar

É chamado pelo framework quando um menu é exibido e o utilizador pressiona uma tecla que não corresponde a um comando.

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

Parâmetros

nChar
[dentro] Código de carácter da tecla pressionada.

nFlags
[dentro] Contém a MF_POPUP bandeira se o menu apresentado for um submenu; contém a MF_SYSMENU bandeira se o menu apresentado for um menu de controlo.

pMenu
[dentro] Aponta para um menu.

Valor de retorno

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

Valor Description
0 O framework deve ignorar as teclas pressionadas.
1 A estrutura deve fechar o menu.
2 O framework deve selecionar um dos itens exibidos no menu. A palavra de ordem baixa contém o ID do comando a selecionar.

CFrameWndEx::OnMouseMove

A estrutura chama este método quando o ponteiro se move.

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

Parâmetros

nFlags
[dentro] Indica se um utilizador pressionou as teclas modificadoras. Para valores possíveis, consulte o parâmetro wParam em WM_MOUSEMOVE Notificação.

point
[dentro] Especifica as x coordenadas e y do ponteiro relativamente ao canto superior esquerdo da janela.

Observações

CFrameWndEx::OnMoveMiniFrame

Chamada pela estrutura quando uma janela de painel se move.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parâmetros

pFrame
[dentro] Aponta para a CPaneFrameWnd janela do painel de Classe .

Valor de retorno

TRUE se a janela de vidro não estivesse acoplada; FALSE Se a janela de vidro estivesse abaixada.

Observações

CFrameWndEx::OnNcActivate

Chamada pela estrutura quando a área não cliente da trama deve ser redesenhada para indicar uma alteração no estado ativo.

afx_msg BOOL OnNcActivate(BOOL bActive);

Parâmetros

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

Valor de retorno

Não zero para continuar com o processamento padrão; 0 para evitar que a área não cliente seja desativada.

Observações

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
[dentro] TRUE quando a aplicação tem de especificar uma área cliente válida; caso contrário, FALSE.

lpncsp
[dentro] Apontador para uma NCCALCSIZE_PARAMS estrutura que contém alterações de dimensão de frame.

Observações

CFrameWndEx::OnNcHitTest

Chamada pela estrutura quando o ponteiro se move ou quando um botão do rato é pressionado ou libertado.

afx_msg LRESULT OnNcHitTest(CPoint point);

Parâmetros

point
[dentro] A localização do ponteiro nas coordenadas do ecrã.

Valor de retorno

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

Observações

CFrameWndEx::OnNcMouseMove

Chamado pela framework quando o ponteiro se move numa área não cliente.

afx_msg void OnNcMouseMove(
    UINT nHitTest,
    CPoint point);

Parâmetros

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

point
[dentro] A localização do ponteiro nas coordenadas do ecrã.

Observações

CFrameWndEx::OnNcPaint

Chamado pela estrutura quando a área não-cliente tem de ser pintada.

afx_msg void OnNcPaint();

Observações

CFrameWndEx::OnPaneCheck

Chamado pela estrutura para controlar a visibilidade de um painel.

afx_msg BOOL OnPaneCheck(UINT nID);

Parâmetros

nID
[dentro] ID de controlo de um painel.

Valor de retorno

TRUE se a ordem fosse cumprida; FALSE para continuar com o processamento de comandos.

Observações

CFrameWndEx::OnPostPreviewFrame

Chamado pelo framework quando o utilizador altera o modo de pré-visualização de impressão.

afx_msg LRESULT OnPostPreviewFrame(
    WPARAM wParam,
    LPARAM lParam);

Parâmetros

wParam
[dentro] Este parâmetro não é usado.

lParam
[dentro] TRUE quando o frame está em modo de pré-visualização de impressão; FALSE Quando o modo de pré-visualização de impressão está desligado.

Valor de retorno

Sempre devolve 0.

Observações

CFrameWndEx::OnPowerBroadcast

É chamado pelo framework quando ocorre um evento de gestão de energia.

afx_msg LRESULT OnPowerBroadcast(
    WPARAM wp,
    LPARAM lp);

Parâmetros

wp
[dentro] O evento de gestão de energia. Para uma lista de valores possíveis, vejaWM_POWERBROADCAST Mensagem.

lp
[dentro] Este parâmetro não é usado.

Valor de retorno

Resultado de chamar o procedimento da janela por defeito.

Observações

CFrameWndEx::OnSetMenu

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

afx_msg LRESULT OnSetMenu(
    WPARAM wp,
    LPARAM lp);

BOOL OnSetMenu(HMENU hmenu);

Parâmetros

wp
[dentro] Handle para o novo menu da janela do frame.

lp
[dentro] Handle para o novo menu de janela.

hmenu
[dentro] Handle para o novo menu da janela do frame.

Valor de retorno

LRESULT é o resultado de chamar o procedimento da janela por defeito.

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

Observações

CFrameWndEx::OnSetPreviewMode

Chamado pelo framework para definir o modo de pré-visualização de impressão para o frame.

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

Parâmetros

bPreview
[dentro] TRUE para permitir a pré-visualização de impressão; FALSE Para desativar a pré-visualização de impressão.

pState
[dentro] Apontador para uma CPrintPreviewState estrutura de estado de enquadramento.

Observações

CFrameWndEx::OnSetText

Chamado pelo framework para definir o texto de uma janela.

afx_msg LRESULT OnSetText(
    WPARAM wParam,
    LPARAM lParam);

Parâmetros

wParam
[dentro] Este parâmetro não é usado.

lParam
[dentro] Aponta para o texto da janela.

Valor de retorno

Valor de retorno de uma chamada para DefWindowProc.

Observações

CFrameWndEx::OnShowCustomizePane

Chamada pela estrutura quando esta apresenta um QuickCustomizePane.

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

Parâmetros

pMenuPane
[dentro] Um apontador para o painel de personalização rápida.

uiToolbarID
[dentro] O ID de controlo da barra de ferramentas para personalizar.

Valor de retorno

Este método devolve TRUEsempre .

Observações

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

CFrameWndEx::OnShowPanes

Chamado pelo framework para mostrar ou ocultar painéis.

virtual BOOL OnShowPanes(BOOL bShow);

Parâmetros

bShow
[dentro] TRUE se a aplicação mostrar os painéis; FALSE caso contrário.

Valor de retorno

Este método devolve FALSEsempre .

Observações

A implementação padrão mostra os painéis se bShow is TRUE e os painéis estão ocultos ou quando bShow is FALSE e os painéis são visíveis.

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

Substitua este método numa classe derivada para executar código personalizado quando o framework mostrar ou esconder painéis.

CFrameWndEx::OnShowPopupMenu

É chamado pelo framework quando aparece um menu pop-up.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenu);

Parâmetros

pMenu
[dentro] Um apontador para um menu pop-up.

Valor de retorno

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

Observações

Substitua este método numa classe derivada para executar código personalizado quando o framework mostrar um menu pop-up. Por exemplo, substitua este método para alterar a cor de fundo dos comandos num menu pop-up.

CFrameWndEx::OnSize

É chamado pelo framework depois de o tamanho do frame mudar.

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

Parâmetros

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

cx
[dentro] Nova largura do enquadramento em pixels.

cy
[dentro] Nova altura do enquadramento em píxeis.

Observações

CFrameWndEx::OnSizing

Chamada pela framework quando o utilizador redimensiona a frame.

afx_msg void OnSizing(
    UINT fwSide,
    LPRECT pRect);

Parâmetros

fwSide
[dentro] A borda do enquadramento que é movida. Consulte o parâmetro wParam na WM_SIZING Notificação.

pRect
[inspira, expira] Apontador para uma CRect estrutura ou RECT que contém as coordenadas do quadro.

Observações

CFrameWndEx::OnSysColorChange

Chamado pela estrutura quando as cores do sistema mudam.

void OnSysColorChange();

Observações

CFrameWndEx::OnTearOffMenu

É chamado pelo framework quando a aplicação apresenta um menu com uma barra de remoção.

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

Parâmetros

pMenuPopup
[dentro] Um apontador para um menu pop-up.

pBar
[dentro] Um apontar para uma barra de remoção.

Valor de retorno

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

Observações

Substitua este método numa classe derivada para executar código personalizado quando o framework mostrar uma barra de controlo.

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

CFrameWndEx::OnToolbarContextMenu

Chamado pelo framework para construir um menu pop-up na barra de ferramentas.

afx_msg LRESULT OnToolbarContextMenu(
    WPARAM wp,
    LPARAM lp);

Parâmetros

wp
[dentro] Este parâmetro não é usado.

lp
[dentro] Este parâmetro não é usado.

Valor de retorno

Devolve sempre 1.

Observações

CFrameWndEx::OnToolbarCreateNew

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

afx_msg LRESULT OnToolbarCreateNew(
    WPARAM wp,
    LPARAM lp);

Parâmetros

wp
[dentro] Este parâmetro não é usado.

lp
[dentro] Aponta para o texto da barra de título da barra de ferramentas.

Valor de retorno

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

Observações

CFrameWndEx::OnToolbarDelete

Chamada pela framework quando uma barra de ferramentas é eliminada.

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

Parâmetros

unused
[dentro] Este parâmetro não é usado.

lp
[dentro] Apontar para uma barra de ferramentas.

Valor de retorno

TRUE se a barra de ferramentas fosse eliminada; caso contrário, FALSE.

Observações

CFrameWndEx::OnUpdateFrameMenu

Chamado pelo framework para definir o menu de frames.

virtual void OnUpdateFrameMenu(HMENU hMenuAlt);

Parâmetros

hMenuAlt
[dentro] Vai para o menu alternativo.

Observações

CFrameWndEx::OnUpdateFrameTitle

O framework chama este método para atualizar a barra de título da janela do frame.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Parâmetros

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

Observações

CFrameWndEx::OnUpdatePaneMenu

Chamado pelo framework para atualizar o menu de painéis.

afx_msg void OnUpdatePaneMenu(CCmdUI* pCmdUI);

Parâmetros

pCmdUI
[dentro] Apontar para o objeto de interface do painel de utilizador.

Observações

CFrameWndEx::OnWindowPosChanged

Chamada pela framework quando o tamanho, posição ou ordem z do frame mudou devido a uma chamada a um método de gestão de janelas.

afx_msg void OnWindowPosChanged(WINDOWPOS FAR* lpwndpos);

Parâmetros

lpwndpos
[dentro] Apontar para uma WINDOWPOS estrutura que contenha o novo tamanho e posição.

Observações

CFrameWndEx::PaneFromPoint

Procura em cada painel o ponto indicado.

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
[dentro] As coordenadas do ecrã do ponto a verificar.

nSensitivity
[dentro] Expanda o retângulo delimitador de cada barra de controlo por esta quantidade ao procurar o ponto.

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

pRTCBarType
[dentro] Se não NULLfor , o método procura apenas as barras de controlo do tipo especificado.

dwAlignment
[fora] Se for bem-sucedido, este parâmetro contém o lado da barra de controlo mais próximo do ponto especificado. Caso contrário, este parâmetro não é inicializado.

Valor de retorno

Um ponteiro para uma barra de controlo que contém o point; NULL se não for encontrado controlo.

Observações

Este método pesquisa todas as barras de controlo da sua aplicação por um point.

Use nSensitivity para aumentar o tamanho da área de pesquisa. Use pRTCBarType para restringir os tipos de barras de controlo que o método procura.

CFrameWndEx::PreTranslateMessage

Trata de mensagens específicas de janelas antes de serem enviadas.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parâmetros

pMsg
[dentro] Um ponteiro para uma MSG estrutura que contém a mensagem a processar.

Valor de retorno

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

Observações

CFrameWndEx::RecalcLayout

Ajusta a disposição da moldura e das suas janelas filhas.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parâmetros

bNotify
[dentro] Especifica se deve notificar o item cliente OLE sobre a alteração de layout.

Observações

Este método é chamado quando o tamanho da janela da moldura mudou ou quando as barras de controlo são exibidas ou ocultas.

CFrameWndEx::RemovePaneFromDockManager

Desregista um painel e remove-o do gestor de docking.

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

Parâmetros

pControlBar
[dentro] Um apontador para o painel da barra de controlo para remover.

bDestroy
[dentro] TRUE destruir a barra de controlo após a sua remoção; FALSE caso contrário.

bAdjustLayout
[dentro] TRUE para ajustar a disposição do acoplamento; FALSE caso contrário.

bAutoHide
[dentro] TRUE se a barra de controlo estiver em modo de ocultação automática; FALSE caso contrário.

pBarReplacement
[dentro] Um apontador para um painel que substitui o painel removido.

Observações

Use este método para remover uma barra de controlo do layout de acoplamento da janela da moldura.

A CDockingManager Classe trata da disposição das barras de controlo. Deve registar cada barra de controlo com o gestor de docking usando o CFrameWndEx::AddPane método ou o CFrameWndEx::InsertPane método.

CFrameWndEx::SetDockState

Restaura o layout de acoplamento para o estado armazenado no registo.

void SetDockState(const CDockState& state);

Parâmetros

state
O estado de acoplamento. Este parâmetro é ignorado.

CFrameWndEx::SetPrintPreviewFrame

Define a janela de pré-visualização do frame de impressão.

void SetPrintPreviewFrame(CFrameWnd* pWnd);

Parâmetros

pWnd
[dentro] Apontar para uma janela de moldura de pré-visualização de impressão.

Observações

CFrameWndEx::SetupToolbarMenu

Insere comandos definidos pelo utilizador num menu da barra de ferramentas.

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

Parâmetros

menu
[dentro] Um CMenu objeto a ser modificado.

uiViewUserToolbarCmdFirst
[dentro] O primeiro comando definido pelo utilizador.

uiViewUserToolbarCmdLast
[dentro] O último comando definido pelo utilizador.

Observações

O framework armazena comandos definidos pelo utilizador numa lista. Use uiViewUserToolbarCmdFirst e uiViewUserToolbarCmdList para especificar os índices dos comandos a inserir.

CFrameWndEx::ShowFullScreen

Alterna o quadro principal entre o modo de ecrã completo e o modo normal.

void ShowFullScreen();

CFrameWndEx::ShowPane

Mostra ou esconde o painel especificado.

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

Parâmetros

pBar
[dentro] Um indicador para a barra de controlo para mostrar ou esconder.

bShow
[dentro] Se TRUE, a aplicação mostra a barra de controlo. Caso contrário, a aplicação esconde a barra de controlo.

bDelay
[dentro] Se TRUE, atrasar o ajuste do layout de acoplamento até que o framework chame CFrameWndEx::AdjustDockingLayout. Caso contrário, recalcule imediatamente o layout de acoplamento.

bActivate
[dentro] Se TRUE, active a barra de controlo. Caso contrário, mostre a barra de controlo num estado inativo.

CFrameWndEx::UpdateCaption

Chamado pelo framework para atualizar a legenda da moldura da janela.

void UpdateCaption();

Observações

CFrameWndEx::WinHelp

Invoca a aplicação WinHelp ou ajuda relacionada com o contexto.

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

Parâmetros

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

nCmd
O comando de ajuda. Para uma lista de valores possíveis, veja WinHelp.

Observações

Consulte também

Gráfico de Hierarquia
Classes
CFrameWnd

  • Last updated on