Classe CFrameWndEx
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. |
CFrameWndEx::WinHelp |
Invoca a ajuda relacionada ao aplicativo ou ao WinHelp 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
Requisitos
Cabeçalho: afxframewndex.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 retorno
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 retorno
TRUE
se pBar
for encaixado com êxito. FALSE
caso contrário.
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 retorno
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 retorno
TRUE
se um painel de barras puder ser encaixado com êxito no lado especificado. FALSE
caso contrário.
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
TRUE
se a dica de ferramenta tiver sido exibida. FALSE
caso contrário.
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
TRUE
se uma janela com minimoldura flutuante puder ser fechada. FALSE
caso contrário.
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 retorno
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 retorno
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 retorno
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
.
CFrameWndEx::OnDrawMenuLogo
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 retorno
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 retorno
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 retorno
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 retorno
TRUE
se o aplicativo preencher o parâmetropTI
. FALSE
caso contrário.
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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 retorno
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
.