Partilhar via

Classe CMDIFrameWndEx

  • Artigo

Estende a funcionalidade da CMDIFrameWnd, uma janela da estrutura MDI (Interface de Documento Múltiplo) do Windows.

Sintaxe

class CMDIFrameWndEx : public CMDIFrameWnd

Membros

Métodos públicos

Nome Descrição
CMDIFrameWndEx::ActiveItemRecalcLayout Recalcula o layout do item ativo.
CMDIFrameWndEx::AddDockSite Esse método não é usado.
CMDIFrameWndEx::AddPane Registra um painel com o gerenciador de encaixe.
CMDIFrameWndEx::AdjustClientArea Reduz a área do cliente para permitir uma borda.
CMDIFrameWndEx::AdjustDockingLayout Recalcula o layout de todos os painéis encaixados.
CMDIFrameWndEx::AreMDITabs Determina se o recurso Guias da MDI ou o recurso Grupos com guias da MDI está habilitado.
CMDIFrameWndEx::CanConvertControlBarToMDIChild Chamado pela estrutura para determinar se a janela de quadros pode converter painéis de encaixe em documentos com guias.
CMDIFrameWndEx::ControlBarToTabbedDocument Converte o painel de encaixe especificado em um documento com guias.
CMDIFrameWndEx::CreateDocumentWindow Cria uma janela do documento filho.
CMDIFrameWndEx::CreateNewWindow Chamado pela estrutura para criar uma nova janela.
CMDIFrameWndEx::CreateObject Usado pela estrutura para criar uma instância dinâmica desse tipo de classe.
CMDIFrameWndEx::DockPane Encaixa o painel especificado na janela com moldura.
CMDIFrameWndEx::DockPaneLeftOf Encaixa um painel à esquerda de outro painel.
CMDIFrameWndEx::EnableAutoHidePanes Habilita o modo de ocultação automática para painéis quando eles são encaixados em lados especificados da janela de quadros principal.
CMDIFrameWndEx::EnableDocking Habilita o encaixe dos painéis que pertencem à janela de quadros da MDI.
CMDIFrameWndEx::EnableFullScreenMainMenu Mostra ou oculta o menu principal no modo de tela inteira.
CMDIFrameWndEx::EnableFullScreenMode Habilita o modo de tela inteira para a janela de quadros.
CMDIFrameWndEx::EnableLoadDockState Habilita ou desabilita o carregamento do estado de encaixe.
CMDIFrameWndEx::EnableMDITabbedGroups Habilita ou desabilita o recurso Grupos com guias da MDI.
CMDIFrameWndEx::EnableMDITabs Habilita ou desabilita o recurso Guias MDI. Quando habilitada, a janela de quadros exibe uma guia para cada janela filho da MDI.
CMDIFrameWndEx::EnableMDITabsLastActiveActivation Especifica se a última guia ativa deve ser ativada quando o usuário fecha a guia atual.
CMDIFrameWndEx::EnablePaneMenu Habilita ou desabilita a criação e o gerenciamento automáticos do menu do painel de item pop-up, que exibe uma lista de painéis de aplicativo.
CMDIFrameWndEx::EnableWindowsDialog Insere um item de menu cuja ID de comando chama uma caixa de diálogo CMFCWindowsManagerDialog.
CMDIFrameWndEx::GetActivePopup Retorna um ponteiro para o menu de item pop-up exibido no momento.
CMDIFrameWndEx::GetPane Retorna um ponteiro para o painel que tem a ID de controle especificada.
CMDIFrameWndEx::GetDefaultResId Retorna a ID dos recursos compartilhados da janela de quadros da MDI.
CMDIFrameWndEx::GetMDITabGroups Retorna uma lista de janelas com guia da MDI.
CMDIFrameWndEx::GetMDITabs Retorna uma referência à janela com guias sublinhada.
CMDIFrameWndEx::GetMDITabsContextMenuAllowedItems Retorna uma combinação de sinalizadores que determina quais itens de menu de contexto são válidos quando o recurso Grupos com guias da MDI está habilitado.
CMDIFrameWndEx::GetMenuBar Retorna um ponteiro para um objeto da barra de menus anexado à janela de quadros.
CMDIFrameWndEx::GetRibbonBar Recupera o controle da barra de faixa de opções para o quadro.
CMDIFrameWndEx::GetTearOffBars Retorna uma lista de objetos derivados de CPane que estão em um estado de destacável.
CMDIFrameWndEx::GetThisClass Chamado pela estrutura para obter um ponteiro para o objeto CRuntimeClass que é associado a esse tipo de classe.
CMDIFrameWndEx::GetToolbarButtonToolTipText Chamado pela estrutura quando o aplicativo exibe a dica de ferramenta para um botão de barra de ferramentas.
CMDIFrameWndEx::InsertPane Registra o painel especificado no gerenciador de encaixe.
CMDIFrameWndEx::IsFullScreen Determina se a janela de quadros está no modo de tela inteira.
CMDIFrameWndEx::IsMDITabbedGroup Determina se o recurso Grupos com guias da MDI está habilitado.
CMDIFrameWndEx::IsMemberOfMDITabGroup Determina se a janela com guias especificada está na lista de janelas que estão nos Grupos com guias da MDI.
CMDIFrameWndEx::IsMenuBarAvailable Determina se a janela de quadros tem uma barra de menus.
CMDIFrameWndEx::IsPointNearDockSite Determina se um ponto especificado está próximo ao local de encaixe.
CMDIFrameWndEx::IsPrintPreview Determina se a janela de quadros está no modo de visualização de impressão.
CMDIFrameWndEx::LoadFrame Cria uma janela de quadros a partir de informações de recurso. (Substitui CMDIFrameWnd::LoadFrame.)
CMDIFrameWndEx::LoadMDIState Carrega o layout especificado dos Grupos com guias da MDI e a lista dos documentos abertos anteriormente.
CMDIFrameWndEx::MDITabMoveToNextGroup Move a guia ativa da janela com guias ativas no momento para o próximo grupo com guias ou para o anterior.
CMDIFrameWndEx::MDITabNewGroup Cria um novo grupo com guias que tem uma única janela.
CMDIFrameWndEx::NegotiateBorderSpace Negocia o espaço de borda em uma janela de quadros durante a ativação local da OLE.
CMDIFrameWndEx::OnCloseDockingPane Chamado pela estrutura quando o usuário clica no botão Fechar em um painel encaixável.
CMDIFrameWndEx::OnCloseMiniFrame Chamado pela estrutura quando o usuário clica no botão Fechar em uma janela com minimoldura flutuante.
CMDIFrameWndEx::OnClosePopupMenu Chamado pela estrutura quando um menu de item pop-up ativo processa uma mensagem WM_DESTROY.
CMDIFrameWndEx::OnCmdMsg Chamado pela estrutura para rotear e expedir mensagens de comando e atualizar objetos da interface do usuário de comando.
CMDIFrameWndEx::OnDrawMenuImage Chamado pela estrutura quando a imagem associada a um item de menu é desenhada.
CMDIFrameWndEx::OnDrawMenuLogo Chamado pela estrutura quando uma CMFCPopupMenu processa uma mensagem WM_PAINT.
CMDIFrameWndEx::OnEraseMDIClientBackground Chamado pela estrutura quando a janela de quadros da MDI processa uma mensagem WM_ERASEBKGND.
CMDIFrameWndEx::OnMenuButtonToolHitTest Chamado pela estrutura quando um objeto CMFCToolBarButton processa uma mensagem WM_NCHITTEST.
CMDIFrameWndEx::OnMoveMiniFrame Chamado pela estrutura para mover uma janela com minimoldura.
CMDIFrameWndEx::OnSetPreviewMode Define o modo de visualização de impressão da janela de quadros principal do aplicativo. (Substitui CFrameWnd::OnSetPreviewMode.)
CMDIFrameWndEx::OnShowCustomizePane Chamado pela estrutura quando um painel de Personalização Rápida é ativado.
CMDIFrameWndEx::OnShowMDITabContextMenu Chamado pela estrutura quando um menu de contexto deve ser exibido em uma das guias. (Válido somente para grupos com guias da MDI.)
CMDIFrameWndEx::OnShowPanes Chamado pela estrutura para exibir ou ocultar painéis.
CMDIFrameWndEx::OnShowPopupMenu Chamado pela estrutura quando um menu pop-up é ativado.
CMDIFrameWndEx::OnSizeMDIClient Chamado pela estrutura quando o tamanho da janela MDI do cliente está sendo alterado.
CMDIFrameWndEx::OnTearOffMenu Chamado pela estrutura quando um menu que tem uma barra destacável é ativado.
CMDIFrameWndEx::OnUpdateFrameMenu Chamado pela estrutura para atualizar o menu de quadros. (Substitui CMDIFrameWnd::OnUpdateFrameMenu.)
CMDIFrameWndEx::PaneFromPoint Retorna o painel de encaixe que contém o ponto especificado.
CMDIFrameWndEx::PreTranslateMessage Usado pela classe CWinApp para converter mensagens de janela antes de serem expedidas para as funções TranslateMessage e DispatchMessage do Windows. (Substitui CMDIFrameWnd::PreTranslateMessage.)
CMDIFrameWndEx::RecalcLayout Chamado pela estrutura para recalcular o layout da janela de quadros. (Substitui CFrameWnd::RecalcLayout.)
CMDIFrameWndEx::RemovePaneFromDockManager Cancela o registro de um painel e o remove do gerenciador de encaixe.
CMDIFrameWndEx::SaveMDIState Salva o layout atual dos Grupos com guias da MDI e a lista dos documentos abertos anteriormente.
CMDIFrameWndEx::SetPrintPreviewFrame Define a janela com moldura de visualização de impressão.
CMDIFrameWndEx::SetupToolbarMenu Modifica um objeto da barra de ferramentas pesquisando itens fictícios e substituindo-os pelos itens definidos pelo usuário especificados.
CMDIFrameWndEx::ShowFullScreen Alterna o quadro principal do modo normal para o modo de tela inteira.
CMDIFrameWndEx::ShowPane Mostra ou oculta o painel especificado.
CMDIFrameWndEx::ShowWindowsDialog Cria e abre uma caixa CMFCWindowsManagerDialog.
CMDIFrameWndEx::TabbedDocumentToControlBar Converte o documento com guias especificado em um painel de encaixe.
CMDIFrameWndEx::UpdateCaption Chamado pela estrutura para atualizar a legenda do quadro de janela.
CMDIFrameWndEx::UpdateMDITabbedBarsIcons Define o ícone para cada painel com guias MDI.
CMDIFrameWndEx::WinHelp Chamado pela estrutura para iniciar o aplicativo WinHelp ou a ajuda de contexto. (Substitui CWnd::WinHelp.)

Membros de dados

Nome Descrição
CMDIFrameWndEx::m_bCanConvertControlBarToMDIChild Determina se os painéis de encaixe podem ser convertidos em janelas filho da MDI.
CMDIFrameWndEx::m_bDisableSetRedraw Habilita ou desabilita a otimização de redesenhar para janelas filho da MDI.

Comentários

Para aproveitar os recursos de personalização estendida em seu aplicativo da MDI, altere a classe da janela de quadros da MDI do aplicativo para CMDIFrameWndEx em vez de CMDIFrameWnd.

Exemplo

O exemplo a seguir deriva uma classe de CMDIFrameWndEx. Esse snippet de código tem origem no Exemplo DrawClient: aplicativo de desenho do objeto de OLE baseado na Faixa de Opções do MFC.

class CMainFrame : public CMDIFrameWndEx
{
   DECLARE_DYNAMIC(CMainFrame)
public:
   struct XStyle
   {
      COLORREF clrFill;
      COLORREF clrLine;
   };

public:
   CMainFrame();

   // Attributes
public:
   CMFCRibbonBar *GetRibbonBar() { return &m_wndRibbonBar; }

   // Operations
public:
   void UpdateUI(CDrawView *pCurrView);
   void UpdateContextTab(CDrawView *pCurrView);
   void UpdateContextTabFromObject(CDrawObjList &list);

   COLORREF GetColorFromColorButton(int nButtonID);
   int GetWeightFromLineWeight(int nButtonID);
   BOOL GetStyleFromStyles(XStyle &style);

   void SetRibbonContextCategory(UINT uiCategoryID);
   void ActivateRibbonContextCategory(UINT uiCategoryID);

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

protected:
   // control bar embedded members
   CMFCRibbonStatusBar m_wndStatusBar;
   CMFCRibbonBar m_wndRibbonBar;

   CMFCRibbonApplicationButton m_MainButton;

   // panel images
   CMFCToolBarImages m_PanelImages;

   // Document colors for demo:
   CList<COLORREF, COLORREF> m_lstMainColors;
   CList<COLORREF, COLORREF> m_lstAdditionalColors;
   CList<COLORREF, COLORREF> m_lstStandardColors;

   // Generated message map functions
protected:
   //{{AFX_MSG(CMainFrame)
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
   afx_msg void OnAppLook(UINT id);
   afx_msg void OnUpdateAppLook(CCmdUI *pCmdUI);
   afx_msg void OnWindowManager();
   afx_msg void OnMdiMoveToNextGroup();
   afx_msg void OnMdiMoveToPrevGroup();
   afx_msg void OnMdiNewHorzTabGroup();
   afx_msg void OnMdiNewVertGroup();
   afx_msg void OnMdiCancel();
   afx_msg LRESULT OnRibbonCustomize(WPARAM wp, LPARAM lp);
   afx_msg LRESULT OnHighlightRibbonListItem(WPARAM wp, LPARAM lp);
   afx_msg void OnToolsOptions();
   afx_msg void OnDummy();
   afx_msg void OnSysColorChange();
   //}}AFX_MSG

   DECLARE_MESSAGE_MAP()

   virtual BOOL OnShowMDITabContextMenu(CPoint point, DWORD dwAllowedItems, BOOL bDrop);
   virtual BOOL OnShowPopupMenu(CMFCPopupMenu *pMenuPopup);

   void ShowOptions(int nPage);
   void CreateDocumentColors();

private:
   BOOL CreateRibbonBar();
   BOOL CreateStatusBar();

   void InitMainButton();
   void InitHomeCategory();
   void InitViewCategory();
   void InitTabButtons();

   void AddContextTab_Format();

   void AdjustObjectSubmenu(CMFCPopupMenu *pMenuPopup);
   void UpdateStatusBarCountPane(int nID, CString strText, int nCount);

   UINT m_nAppLook;
};

Hierarquia de herança

CObject

CCmdTarget

CWnd

CFrameWnd

CMDIFrameWnd

CMDIFrameWndEx

Requisitos

Cabeçalho: afxMDIFrameWndEx.h

CMDIFrameWndEx::ActiveItemRecalcLayout

Recalcula o layout do item ativo.

void ActiveItemRecalcLayout();

CMDIFrameWndEx::AddPane

Registra um painel com o gerenciador de encaixe.

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

Parâmetros

pControlBar
[in] Ponteiro para o painel a ser registrado.

bTail
[in] Especifica se o painel deve ser adicionado ao final da lista.

Valor retornado

Retorna um valor diferente de zero se o painel for registrado com êxito. Retorna 0 se o painel já estiver registrado no gerenciador de encaixes.

Comentários

Cada painel deve ser registrado com a Classe CDockingManager para poder participar do layout de encaixe. Use esse método para notificar o gerenciador de encaixes de que você deseja encaixar um painel específico. Após o registro do painel, o gerenciador de encaixe o alinha com base na configuração de alinhamento e posição dele na lista de painéis mantidos pelo gerenciador de encaixes.

CMDIFrameWndEx::AdjustClientArea

Reduz a área do cliente para permitir uma borda.

virtual void AdjustClientArea();

CMDIFrameWndEx::AdjustDockingLayout

Recalcula o layout de todos os painéis encaixados.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Parâmetros

hdwp
[in] Identifica a estrutura de várias posições de janela. Você pode obter esse valor chamando BeginDeferWindowPos.

Comentários

Chame essa função de membro para recalcular o layout de todos os painéis encaixados na janela de quadros.

CMDIFrameWndEx::AreMDITabs

Determina se o recurso guias da MDI ou o recurso grupos com guias da MDI está habilitado.

BOOL AreMDITabs(int* pnMDITabsType=NULL) const;

Parâmetros

pnMDITabsType
[out] Um ponteiro para uma variável de inteiro que indica quais recursos estão habilitados:

  • 0: todos os recursos estão desabilitados.
  • 1: as guias MDI estão habilitadas.
  • 2: os grupos com guias da MDI estão habilitados.

Valor retornado

Retorna TRUE se as guias MDI ou grupos com guias da MDI estiverem habilitados.

Retorna FALSE se nenhum dos recursos acima estiver habilitado.

Comentários

Use essa função para determinar se as guias MDI ou grupos com guias da MDI estão habilitados para a janela de quadros. Use CMDIFrameWndEx::EnableMDITabs para habilitar ou desabilitar o recurso das guias MDI.

Use CMDIFrameWndEx::EnableMDITabbedGroups para habilitar ou desabilitar o recurso dos grupos com guias da MDI.

CMDIFrameWndEx::CanConvertControlBarToMDIChild

Chamado pela estrutura para determinar se a janela de quadros pode converter painéis de encaixe em documentos com guias

virtual BOOL CanConvertControlBarToMDIChild();

Valor de retorno

Retorna TRUE se a janela de quadros puder converter painéis de encaixe em documentos com guias; caso contrário, retorna FALSE.

Comentários

Substitua esse método em uma classe derivada e retorne TRUE para habilitar a conversão de painéis de encaixe em documentos com guias. Como alternativa, você pode definir CMDIFrameWndEx::m_bCanConvertControlBarToMDIChild como TRUE.

CMDIFrameWndEx::ControlBarToTabbedDocument

Converte o painel de encaixe especificado em um documento com guias.

virtual CMDIChildWndEx* ControlBarToTabbedDocument(CDockablePane* pBar);

Parâmetros

pBar
Um ponteiro para o painel de encaixe que será convertido.

Valor de retorno

Retorna um ponteiro para a nova janela filho da MDI que contém o painel de encaixe.

Comentários

Esse método converte um painel de encaixe em um documento com guias. Quando você chama esse método, a estrutura cria um objeto da classe CMDIChildWndEx, remove o painel de encaixe do gerenciador de encaixes e adiciona o painel de encaixe à nova janela filho da MDI. A janela filho da MDI redimensiona o painel de encaixe para cobrir toda a área do cliente

CMDIFrameWndEx::CreateDocumentWindow

Cria uma janela do documento filho.

virtual CMDIChildWndEx* CreateDocumentWindow(
    LPCTSTR lpcszDocName,
    CObject* pObj);

Parâmetros

lpcszDocName
[in] Uma cadeia de caracteres de texto que contém um identificador de documento. Normalmente, é o caminho completo de um arquivo de documento.

pObj
[in] Um ponteiro para um objeto definido pelo usuário. Por exemplo, um desenvolvedor pode criar uma estrutura de dados específica do aplicativo descrevendo o documento e informando como o documento deve ser inicializado no momento da inicialização.

Valor retornado

Um ponteiro para CMDIChildWndEx.

Comentários

A estrutura chama esse método ao carregar a lista de documentos salvos anteriormente no registro.

Substitua esse método para criar documentos quando eles estão sendo carregados do registro.

Exemplo

O exemplo a seguir mostra como CreateDocumentWindow é usado no Exemplo do VisualStudioDemo: aplicativo MFC do Visual Studio.

Neste exemplo, g_strStartViewName pode ser o nome de um "documento virtual" (por exemplo, "Página Inicial") que não é carregado de um arquivo de disco. Portanto, precisamos de processamento especial para tratar esse caso.

CMainFrame::CMainFrame()
{
   CMFCPopupMenu::SetForceShadow(TRUE);
   m_bCanConvertControlBarToMDIChild = TRUE;
}

CMDIFrameWndEx::CreateNewWindow

Chamado pela estrutura para criar uma nova janela.

virtual CMDIChildWndEx* CreateNewWindow(
    LPCTSTR lpcszDocName,
    CObject* pObj);

Parâmetros

lpcszDocName
[in] O nome do documento.

pObj
[in] Reservado para uso futuro.

Valor retornado

Um ponteiro para a nova janela.

CMDIFrameWndEx::DockPane

Encaixa o painel especificado na janela com moldura.

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

Parâmetros

pBar
[in] Ponteiro para o painel que será encaixado.

nDockBarID
[in] Especifica quais lados da janela de quadros serão encaixados.

lpRect
[in] Não é usado.

Comentários

Esse método encaixa o painel especificado em um dos lados da janela de quadros que foi especificada quando CBasePane::EnableDocking e CMDIFrameWndEx::EnableDocking foram chamados.

Exemplo

O exemplo a seguir demonstra o uso do método DockPane. Esse snippet de código vem do Exemplo do VisualStudioDemo: Aplicativo do Visual Studio MFC.

DockPane(&m_wndMenuBar);
DockPane(&m_wndToolBar);
DockPane(&m_wndPropertiesBar);

DockPane(&m_wndToolbarBuild);

CMDIFrameWndEx::DockPaneLeftOf

Encaixa um painel à esquerda de outro painel.

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

Parâmetros

pBar
[in] Um ponteiro para o painel de encaixes.

pLeftOf
[in] Um ponteiro para o painel que serve como o local do encaixe.

Valor retornado

Retorna TRUE se a operação for bem-sucedida. Caso contrário, retornará FALSE.

Comentários

Chame esse método para encaixar vários objetos de painel em uma ordem predefinida. Esse método encaixa o painel especificado por pBar à esquerda do painel especificado por pLeftOf.

Exemplo

O exemplo a seguir mostra como o método DockPaneLeftOf é usado no Exemplo do VisualStudioDemo: aplicativo MFC do Visual Studio.

DockPane(&m_wndToolbarBuild);
DockPaneLeftOf(&m_wndToolbarEdit, &m_wndToolbarBuild);

CMDIFrameWndEx::EnableAutoHidePanes

Habilita o modo de ocultação automática para painéis quando eles são encaixados nos lados especificados da janela de quadros principal.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parâmetros

dwDockStyle
[in] Especifica os lados da janela de quadros principal que será habilitada. Use um ou mais dos sinalizadores a seguir.

  • CBRS_ALIGN_LEFT
  • CBRS_ALIGN_RIGHT
  • CBRS_ALIGN_TOP
  • CBRS_ALIGN_BOTTOM

Valor retornado

Chame essa função para habilitar o modo de ocultação automática de painéis quando eles são encaixados nos lados especificados da janela de quadros principal.

Exemplo

O exemplo a seguir mostra como o método EnableAutoHidePanes é usado no Exemplo do VisualStudioDemo: aplicativo MFC do Visual Studio.

EnableAutoHidePanes(CBRS_ALIGN_ANY);

Comentários

CMDIFrameWndEx::EnableDocking

Habilita o encaixe dos painéis que pertencem à janela de quadros da MDI.

BOOL EnableDocking(DWORD dwDockStyle);

Parâmetros

dwDockStyle
[in] Especifica o estilo de encaixe que você deseja aplicar.

Valor retornado

Comentários

Chame essa função para habilitar o encaixe de painéis que pertencem ao objeto CMDIFrameWndEx.

Exemplo

O exemplo a seguir mostra como o método EnableDocking é usado no Exemplo do VisualStudioDemo: aplicativo MFC do Visual Studio.

EnableDocking(CBRS_ALIGN_ANY);

CMDIFrameWndEx::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 no modo de tela inteira ou FALSE para ocultá-lo.

Comentários

CMDIFrameWndEx::EnableFullScreenMode

Habilita o modo de tela inteira para a janela de quadros.

void EnableFullScreenMode(UINT uiFullScreenCmd);

Parâmetros

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

Comentários

No modo tela inteira, todas as barras de controle de encaixe, as barras de ferramentas e o menu ficam ocultos e a exibição ativa é redimensionada para ocupar a tela inteira. Ao habilitar o modo tela inteira, você deve especificar uma ID do comando que o habilita ou desabilita. Você pode chamar EnableFullScreenMode a partir da função OnCreate do quadro principal. Quando uma janela de quadros é 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 CMDIFrameWndEx::EnableFullScreenMainMenu.

CMDIFrameWndEx::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.

Comentários

CMDIFrameWndEx::EnableMDITabbedGroups

Habilita ou desabilita o recurso de grupos com guia da MDI para a janela de quadros.

void EnableMDITabbedGroups(
    BOOL bEnable,
    const CMDITabInfo& params);

Parâmetros

bEnable
[in] Se for TRUE, o recurso de grupos com guias da MDI é habilitado; se for FALSE o recurso de grupos com guias da MDI é desabilitado.

params
[in] Especifica parâmetros que a estrutura aplica às janelas filho que são criadas na área do cliente da MDI.

Comentários

Use esse método para habilitar ou desabilitar o recurso dos grupos com guias da MDI. Esse recurso permite que aplicativos MDI exibam janelas filho como janelas com guias alinhadas de maneira vertical ou horizontal dentro da área do cliente MDI. Grupos de janelas com guias são separados por divisores. O usuário pode redimensionar grupos com guias usando um divisor.

O usuário pode:

  • Arrastar guias individuais entre grupos.
  • Arrastar guias individuais até a borda da janela para criar novos grupos.
  • Mover guias ou criar novos grupos usando um menu de atalho.
  • Seu aplicativo pode salvar o layout atual de janelas com guias e a lista de documentos abertos no momento.

Se você chamar esse método com bEnable definido como FALSE, params será ignorado.

Mesmo que os grupos com guia MDI já estejam habilitados, você pode chamar esse método novamente para modificar as configurações das janelas filho. Chame o método com bEnable definido como TRUE e modifique os membros do objeto CMDITabInfo especificados pelo parâmetro params.

Para obter mais informações sobre como usar grupos com guias MDI, consulte Grupos de Guias MDI.

Exemplo

O exemplo a seguir mostra como EnableMDITabbedGroups é usado no Exemplo do VisualStudioDemo: aplicativo MFC do Visual Studio.

CMDITabInfo mdiTabParams;
mdiTabParams.m_bTabCustomTooltips = TRUE;

if (bMDITabsVS2005Look)
{
   mdiTabParams.m_style = CMFCTabCtrl::STYLE_3D_VS2005;
   mdiTabParams.m_bDocumentMenu = TRUE;
}
else if (bOneNoteTabs)
{
   mdiTabParams.m_style = CMFCTabCtrl::STYLE_3D_ONENOTE;
   mdiTabParams.m_bAutoColor = bMDITabColors;
}

if (bActiveTabCloseButton)
{
   mdiTabParams.m_bTabCloseButton = FALSE;
   mdiTabParams.m_bActiveTabCloseButton = TRUE;
}

EnableMDITabbedGroups(TRUE, mdiTabParams);

CMDIFrameWndEx::EnableMDITabs

Habilita ou desabilita o recurso de Guias MDI para a janela de quadros da MDI. Quando habilitada, a janela de quadros exibe uma guia para cada janela filho da MDI.

void EnableMDITabs(
    BOOL bEnable=TRUE,
    BOOL bIcons=TRUE,
    CMFCTabCtrl::Location tabLocation=CMFCTabCtrl::LOCATION_BOTTOM,
    BOOL bTabCloseButton=FALSE,
    CMFCTabCtrl::Style style=CMFCTabCtrl::STYLE_3D_SCROLLED,
    BOOL bTabCustomTooltips=FALSE,
    BOOL bActiveTabCloseButton=FALSE);

Parâmetros

bEnable
Especifica se as guias estão habilitadas.

bIcons
Especifica se os ícones devem ser exibidos nas guias.

tabLocation
Especifica o local dos rótulos de guia.

bTabCloseButton
Especifica se os botões de fechamento da guia devem ser exibidos.

style
Especifica o estilo de guias. Use STYLE_3D_SCROLLED para guias normais ou STYLE_3D_ONENOTE para guias do Microsoft OneNote.

bTabCustomTooltips
Especifica se as dicas de ferramentas personalizadas estão habilitadas.

bActiveTabCloseButton
Se for TRUE, um botão Fechar será exibido na guia ativa, em vez de no canto direito da área da guia.

Comentários

Chame esse método para habilitar ou desabilitar o recurso de guias MDI para a janela de quadros da MDI. Quando habilitadas, todas as janelas filho são exibidas como guias.

Os rótulos de guia podem estar localizados na parte superior ou inferior do quadro, dependendo da configuração do parâmetro tabLocation. Você pode especificar CMFCTabCtrl::LOCATION_BOTTOM (a configuração padrão) ou CMFCTabCtrl::LOCATION_TOP.

Se bTabCustomTooltips for TRUE, uma mensagem AFX_WM_ON_GET_TAB_TOOLTIP será enviada para a janela de quadros principal. Seu código pode tratar essa mensagem e fornecer à estrutura dicas de ferramentas personalizadas para guias da MDI.

Exemplo

O exemplo a seguir mostra como EnableMDITabs é usado no Exemplo MDITabsDemo: aplicativo MDI com guias MFC.

void CMainFrame::UpdateMDITabs(BOOL bResetMDIChild)
{
   CMDITabInfo params;
   HWND hwndActive = NULL;

   switch (theApp.m_Options.m_nMDITabsType)
   {
   case CMDITabOptions::None:
   {
      BOOL bCascadeMDIChild = FALSE;

      if (IsMDITabbedGroup())
      {
         EnableMDITabbedGroups(FALSE, params);
         bCascadeMDIChild = TRUE;
      }
      else if (AreMDITabs())
      {
         EnableMDITabs(FALSE);
         bCascadeMDIChild = TRUE;
      }

      if (bCascadeMDIChild)
      {
         // CMDIClientAreaWnd m_wndClientArea
         hwndActive = (HWND)m_wndClientArea.SendMessage(WM_MDIGETACTIVE);
         m_wndClientArea.PostMessage(WM_MDICASCADE);
         m_wndClientArea.UpdateTabs(false);
         m_wndClientArea.SetActiveTab(hwndActive);
         ::BringWindowToTop(hwndActive);
      }
   }
   break;

   case CMDITabOptions::MDITabsStandard:
      hwndActive = (HWND)m_wndClientArea.SendMessage(WM_MDIGETACTIVE);
      m_wndClientArea.PostMessage(WM_MDIMAXIMIZE, LPARAM(hwndActive), 0L);
      ::BringWindowToTop(hwndActive);

      EnableMDITabs(TRUE, theApp.m_Options.m_bMDITabsIcons, theApp.m_Options.m_bTabsOnTop ? CMFCTabCtrl::LOCATION_TOP : CMFCTabCtrl::LOCATION_BOTTOM, theApp.m_Options.m_nTabsStyle);

      GetMDITabs().EnableAutoColor(theApp.m_Options.m_bTabsAutoColor);
      GetMDITabs().EnableTabDocumentsMenu(theApp.m_Options.m_bMDITabsDocMenu);
      GetMDITabs().EnableTabSwap(theApp.m_Options.m_bDragMDITabs);
      GetMDITabs().SetTabBorderSize(theApp.m_Options.m_nMDITabsBorderSize);
      GetMDITabs().SetFlatFrame(theApp.m_Options.m_bFlatFrame);
      GetMDITabs().EnableCustomToolTips(theApp.m_Options.m_bCustomTooltips);
      GetMDITabs().EnableCustomToolTips(theApp.m_Options.m_bCustomTooltips);
      GetMDITabs().EnableActiveTabCloseButton(theApp.m_Options.m_bActiveTabCloseButton);
      break;

CMDIFrameWndEx::EnableMDITabsLastActiveActivation

Especifica se a última guia ativa deve ser aberta quando o usuário fecha a guia atual.

void EnableMDITabsLastActiveActivation(BOOL bLastActiveTab=TRUE);

Parâmetros

bLastActiveTab
[in] Se for TRUE, habilite a ativação da última guia ativa. Se for FALSE, desabilite a ativação da última guia ativa.

Comentários

Há duas maneiras de abrir uma guia quando a guia ativa é fechada:

  • Ative a próxima guia.
  • Ative a guia ativa anteriormente.

A implementação padrão usa a primeira maneira.

Use EnableMDITabsLastActiveActivation para habilitar a segunda maneira de ativação de guia. Isso emula a maneira como o Windows abre janelas filho da MDI.

CMDIFrameWndEx::EnablePaneMenu

Habilita ou desabilita a criação e o gerenciamento automáticos do menu do painel de item pop-up, que exibe uma lista de painéis de aplicativo.

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

Parâmetros

bEnable
[in] Se for TRUE o tratamento automático do menu do painel é habilitado e se for FALSE o tratamento automático é desabilitado.

uiCustomizeCmd
[in] ID de comando do item de menu Personalizar. Esse item de menu geralmente é adicionado ao final da lista de painéis.

strCustomizeLabel
[in] O texto a ser exibido para o item de menu Personalizar (para localização).

uiViewToolbarsMenuEntryID
[in] Especifica a ID de um item de menu da barra de ferramentas que abre o menu do painel. Normalmente, esse é o submenu Barras de Ferramentas do menu Exibir.

bContextMenuShowsToolbarsOnly
[in] Se for TRUE, o menu do painel exibe apenas uma lista de barras de ferramentas. Se for FALSE, o menu exibe uma lista de barras de ferramentas e barras de encaixe.

bViewMenuShowsToolbarsOnly
[in] Se for TRUE, o menu do painel exibe apenas uma lista de barras de ferramentas. Se for FALSE, o menu exibe uma lista de barras de ferramentas e barras de encaixe.

Comentários

O menu do painel de item pop-up exibe a lista dos painéis do aplicativo e permite que o usuário mostre ou oculte painéis individuais.

Exemplo

O exemplo a seguir mostra como EnablePaneMenu é usado no Exemplo do VisualStudioDemo: aplicativo MFC do Visual Studio.

// Enable pane context menu(list of bars + customize command):
EnablePaneMenu(TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."), ID_VIEW_TOOLBARS, FALSE, TRUE);

CMDIFrameWndEx::EnableWindowsDialog

Insere um item de menu cuja ID de comando chama uma caixa de diálogo CMFCWindowsManagerDialog.

void EnableWindowsDialog(
    UINT uiMenuId,
    LPCTSTR lpszMenuText,
    BOOL bShowAllways=FALSE,
    BOOL bShowHelpButton=FALSE);

void EnableWindowsDialog(
    UINT uiMenuId,
    UINT uiMenuTextResId,
    BOOL bShowAllways=FALSE,
    BOOL bShowHelpButton=FALSE);

Parâmetros

uiMenuId
[in] Especifica a ID do recurso de um menu.

lpszMenuText
[in] Especifica o texto do item.

bShowHelpButton
[in] Especifica se é necessário exibir um botão Ajuda na caixa de diálogo de gerenciamento do Windows.

uiMenuTextResId
[in] O identificador de recurso da cadeia de caracteres que contém a cadeia de caracteres de texto do item.

Comentários

Use esse método para inserir um item de menu cujo comando chama uma caixa de diálogo de gerenciamento de janela filho da MDI (classe CMFCWindowsManagerDialog). O novo item é inserido no menu especificado por uiMenuId. Chame EnableWindowsDialog quando você processar a mensagem WM_CREATE.

Exemplo

O exemplo a seguir mostra como EnableWindowsDialog é usado no Exemplo do VisualStudioDemo: aplicativo MFC do Visual Studio.

// Enable windows manager:
EnableWindowsDialog(ID_WINDOW_MANAGER, _T("Windows..."), TRUE);

CMDIFrameWndEx::GetActivePopup

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

CMFCPopupMenu* GetActivePopup() const;

Valor retornado

Um ponteiro para o menu de item pop-up ativo; NULL se não houver menu de item pop-up ativo.

Comentários

Use essa função para obter um ponteiro para o objeto classe CMFCPopupMenu exibido no momento.

CMDIFrameWndEx::GetDefaultResId

Retorna a ID dos recursos compartilhados da janela de quadros da MDI.

UINT GetDefaultResId() const;

Valor retornado

Um valor de ID do recurso. 0 se a janela de quadros não tiver nenhuma barra de menus.

Comentários

Esse método retorna a ID do recurso que foi especificada quando a janela do quadros da MDI foi carregada por CFrameWnd::LoadFrame.

CMDIFrameWndEx::GetMDITabGroups

Retorna uma lista de janelas com guia da MDI.

const CObList& GetMDITabGroups() const;

Valor retornado

Uma referência a um objeto classe CObList que contém uma lista de janelas com guias. Não armazene nem modifique a lista.

Comentários

Use esse método para acessar a lista de janelas com guias. Isso pode ser útil caso deseje alterar ou consultar alguns parâmetros de janelas com guias individuais.

CMDIFrameWndEx::GetMDITabs

Retorna uma referência à janela com guias sublinhada.

CMFCTabCtrl& GetMDITabs();

Valor retornado

Uma referência à janela com guias sublinhada.

CMDIFrameWndEx::GetMDITabsContextMenuAllowedItems

Retorna uma combinação de sinalizadores que determina quais operações são válidas quando o recurso Grupos com guias da MDI está habilitado.

DWORD GetMDITabsContextMenuAllowedItems();

Valor retornado

Uma combinação bit a bit "ou" (|) dos seguintes sinalizadores:

  • AFX_MDI_CREATE_VERT_GROUP - pode criar um grupo de guias vertical.
  • AFX_MDI_CREATE_HORZ_GROUP - pode criar um grupo de guias horizontal.
  • AFX_MDI_CAN_MOVE_PREV - pode mover uma guia para o grupo de guias anterior.
  • AFX_MDI_CAN_MOVE_NEXT - pode mover uma guia para o próximo grupo de guias.

Comentários

Quando o recurso Grupos com guias da MDI for habilitado, você deve saber quais operações são permitidas nas guias de uma janela específica. Esse método analisa o layout atual das janelas com guias e retorna uma combinação de sinalizadores que podem ser usados para criar, por exemplo, um menu de atalho.

Você pode criar um novo grupo de guias verticais quando todas as janelas com guias forem alinhadas verticalmente ou quando houver apenas uma janela com guias.

Você pode criar um novo grupo de guias horizontais quando todas as janelas com guias forem alinhadas horizontalmente ou quando houver apenas uma janela com guias.

Você pode mover uma guia para o grupo anterior somente se houver mais de uma guia em uma janela com guias.

Você pode mover uma guia para o grupo seguinte somente se houver mais de uma guia em uma janela com guias.

CMDIFrameWndEx::GetMenuBar

Retorna um ponteiro para um objeto da barra de menus anexado à janela de quadros.

const CMFCMenuBar* GetMenuBar() const;

Valor retornado

Um ponteiro para um objeto da barra de menus.

CMDIFrameWndEx::GetPane

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

CBasePane* GetPane(UINT nID);

Parâmetros

nID
[entrada] A ID de controle.

Valor retornado

Um ponteiro para o painel que tem a ID de controle especificada, se ela existir. Caso contrário, NULL.

CMDIFrameWndEx::GetRibbonBar

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

CMFCRibbonBar* GetRibbonBar();

Valor retornado

Ponteiro para a classe CMFCRibbonBar do quadro.

Comentários

CMDIFrameWndEx::GetTearOffBars

Retorna uma lista de menus destacáveis.

const CObList& GetTearOffBars() const;

Valor retornado

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

Comentários

CMDIFrameWndEx mantém uma coleção de menus destacáveis. Use esse método para recuperar uma referência a essa lista.

CMDIFrameWndEx::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 retornado

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

Comentários

CMDIFrameWndEx::InsertPane

Registra o painel especificado no gerenciador de encaixe.

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

Parâmetros

pControlBar
[in] Um ponteiro para que o painel seja inserido.

pTarget
[in] Um ponteiro para o painel antes ou depois do qual inserir o painel.

bAfter
[in] Se for TRUE, pControlBar será inserido depois de pTarget. Se for FALSE, pControlBar será inserido antes de pTarget.

Valor retornado

TRUE se o método registrar com êxito o painel, FALSE se o painel já estiver registrado no gerenciador de encaixes.

Comentários

Use esse método para informar o gerenciador de encaixes de um painel especificado por pControlBar. O gerenciador de encaixes alinhará esse painel de acordo com o alinhamento e a posição do painel na lista interna do gerenciador de encaixes.

CMDIFrameWndEx::IsFullScreen

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

BOOL IsFullScreen() const;

Valor retornado

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 CMDIFrameWndEx::EnableFullScreenMode.

CMDIFrameWndEx::IsMDITabbedGroup

Especifica se o recurso Grupos com guias da MDI está habilitado.

BOOL IsMDITabbedGroup() const;

Valor retornado

TRUE se o recurso Grupos com guias da MDI estiver habilitado; caso contrário FALSE.

Comentários

Para determinar se as guias da MDI normais ou se o recurso Grupos com guias da MDI está habilitado, use CMDIFrameWndEx::AreMDITabs.

CMDIFrameWndEx::IsMemberOfMDITabGroup

Determina se a janela com guias especificada está na lista de janelas que estão nos Grupos com guias da MDI.

BOOL IsMemberOfMDITabGroup(CWnd* pWnd);

Parâmetros

pWnd
[in] Um ponteiro para a janela com guias.

Valor retornado

TRUE se a janela com guias especificada estiver na lista de janelas com guias que formam Grupos com guias da MDI. Caso contrário, FALSE.

CMDIFrameWndEx::IsMenuBarAvailable

Determina se a janela de quadros tem uma barra de menus.

BOOL IsMenuBarAvailable() const;

Valor retornado

TRUE se o ponteiro para o objeto da barra de menus não for NULL; caso contrário FALSE.

CMDIFrameWndEx::IsPointNearDockSite

Determina se um ponto especificado está próximo ao local de encaixe.

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

Parâmetros

point
[in] O ponto especificado nas coordenadas da tela.

dwBarAlignment
[in] Especifica de qual borda o ponto está próximo. Os valores possíveis são CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP e CBRS_ALIGN_BOTTOM

bOuterEdge
[in] TRUE se o ponto estiver próximo à borda externa do local de encaixe; caso contrário, FALSE.

Valor retornado

TRUE se o ponto estiver próximo ao local de encaixe; caso contrário, FALSE.

Comentários

O ponto fica próximo ao local de encaixe quando está dentro da sensibilidade definida no gerenciador de encaixe. A sensibilidade padrão é de 15 pixels.

CMDIFrameWndEx::IsPrintPreview

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

BOOL IsPrintPreview();

Valor retornado

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

Comentários

CMDIFrameWndEx::LoadFrame

Cria uma janela de quadros a partir de informações de recurso.

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

Parâmetros

nIDResource
[in] A ID de um recurso compartilhado associado à janela de quadros.

dwDefaultStyle
[in] O estilo da janela de quadros.

pParentWnd
[in] Um ponteiro para o pai de quadro.

pContext
[in] Um ponteiro para uma EstruturaCCreateContext. Esse parâmetro pode ser NULL.

Valor retornado

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

CMDIFrameWndEx::LoadMDIState

Carrega o layout especificado dos Grupos com guias da MDI e a lista dos documentos abertos anteriormente.

virtual BOOL LoadMDIState(LPCTSTR lpszProfileName);

Parâmetros

lpszProfileName
[in] Especifica o nome do perfil.

Valor retornado

TRUE se o carregamento for bem-sucedido; FALSE se o carregamento falhou ou não há dados para carregar.

Comentários

Para carregar ou salvar o estado das guias e grupos da MDI e a lista de documentos abertos, faça o seguinte:

  • Chamar CMDIFrameWndEx::SaveMDIState quando o quadro principal estiver sendo fechado
  • Chamar CMDIFrameWndEx::LoadMDIState quando o quadro principal estiver sendo criado. O local recomendado para essa chamada é antes que o quadro principal seja exibido pela primeira vez. Adicionar CWinAppEx::EnableLoadWindowPlacement (FALSE); antes pMainFrame->LoadFrame (IDR_MAINFRAME);. de Adicionar (pMainFrame); CWinAppEx::ReloadWindowPlacement após a chamada para LoadMDIState exibir o quadro principal na posição que foi armazenada no Registro.
  • Substitua GetDocumentName na classe derivada-CMDIChildWndEx se o aplicativo exibir documentos que não foram armazenados como arquivos. A cadeia de caracteres retornada será salva no registro como o identificador do documento. A implementação base de CMDIChildWndEx::GetDocumentName retorna um valor obtido de CDocument::GetPathName.
  • Substitua CMDIFrameWndEx::CreateDocumentWindow para criar documentos corretamente quando eles estiverem sendo carregados do registro. O primeiro parâmetro é a cadeia de caracteres que retornou GetDocumentName.

Exemplo

O exemplo a seguir mostra como LoadMDIState é usado no Exemplo do VisualStudioDemo: aplicativo MFC do Visual Studio.

// Parse command line for standard shell commands, DDE, file open
CCommandLineInfo cmdInfo;
ParseCommandLine(cmdInfo);

if (cmdInfo.m_nShellCommand == CCommandLineInfo::FileNew)
{
   if (!pMainFrame->LoadMDIState(GetRegSectionPath()))
   {
      m_pStartDocTemplate->OpenDocumentFile(NULL);
   }
}
else
{
   // Dispatch commands specified on the command line
   if (!ProcessShellCommand(cmdInfo))
   {
      return FALSE;
   }
}

CMDIFrameWndEx::MDITabMoveToNextGroup

Move a guia ativa da janela com guias ativas no momento para o próximo grupo com guias ou para o anterior.

void MDITabMoveToNextGroup(BOOL bNext=TRUE);

Parâmetros

bNext
[in] Se for TRUE, mova a guia para o próximo grupo com guias. Se for FALSE, mova-a para o grupo com guias anterior.

CMDIFrameWndEx::MDITabNewGroup

Cria um novo grupo com guias que tem uma única janela.

void MDITabNewGroup(BOOL bVert=TRUE);

Parâmetros

bVert
[in] Especifica o alinhamento do grupo novo. Se for TRUE, o novo grupo é alinhado verticalmente. Se for FALSE, o novo grupo é alinhado horizontalmente.

Comentários

Use essa função para criar uma nova janela com guias (novo grupo com guias) e adicione a primeira guia a ela.

Exemplo

O exemplo a seguir mostra como MDITabNewGroup é usado no Exemplo do VisualStudioDemo: aplicativo MFC do Visual Studio.

void CMainFrame::OnMdiNewHorzTabGroup()
{
   MDITabNewGroup(FALSE);
}

CMDIFrameWndEx::m_bCanConvertControlBarToMDIChild

Especifica se os painéis de encaixe podem ser convertidos em janelas filho da MDI.

BOOL m_bCanConvertControlBarToMDIChild;

Comentários

Indica se as barras de controle de encaixe podem ser convertidas em janelas filho da MDI. Se esse sinalizador for TRUE, a estrutura trata a conversão de forma automática quando o usuário selecionar o comando Documento com Guias. O sinalizador é protegido e você deve habilitar explicitamente essa opção definindo m_bCanConvertControlBarToMDIChild em um construtor de uma classe derivada-CMDIFrameWndEx ou substituindo CanConvertControlBarToMDIChild.

O valor padrão é FALSE.

Exemplo

O exemplo a seguir mostra como m_bCanConvertControlBarToMDIChild é usado no Exemplo do VisualStudioDemo: aplicativo MFC do Visual Studio.

CMainFrame::CMainFrame()
{
   CMFCPopupMenu::SetForceShadow(TRUE);
   m_bCanConvertControlBarToMDIChild = TRUE;
}

CMDIFrameWndEx::m_bDisableSetRedraw

Habilita ou desabilita a otimização de redesenhar para janelas filho da MDI.

AFX_IMPORT_DATA static BOOL m_bDisableSetRedraw;

Comentários

O valor padrão é TRUE.

Defina esse sinalizador para FALSE se você desejar otimizar o redesenho de filhos da MDI. Nesse caso, a estrutura chamará SetRedraw (FALSE) para o quadro principal quando o aplicativo estiver alterando a guia ativa.

Esse sinalizador pode causar efeitos indesejados (como tornar aplicativos em segundo plano visíveis). Portanto, recomendamos que você altere o padrão somente se tiver uma cintilação perceptível durante a ativação da guia MDI.

CMDIFrameWndEx::NegotiateBorderSpace

Negocia o espaço de borda em uma janela de quadros durante a ativação local da OLE.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Parâmetros

nBorderCmd
[in] Contém um dos seguintes valores de enumeração CFrameWnd::BorderCmd:

  • borderGet = 1
  • borderRequest = 2
  • borderSet = 3

lpRectBorder
[in, out] Ponteiro para um objeto estrutura RECT ou classe CRect que especifica as coordenadas da borda.

Valor retornado

Diferente de zero se o método foi bem-sucedido; caso contrário, 0.

Comentários

Esse método é uma implementação da negociação de espaço de borda OLE.

CMDIFrameWndEx::OnCloseDockingPane

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

virtual BOOL OnCloseDockingPane(CDockablePane* pWnd);

Parâmetros

pWnd
[in] Ponteiro para o painel que está sendo fechado.

Valor retornado

TRUE se o painel de encaixe puder ser fechado. Caso contrário, FALSE.

Comentários

Substitua esse método para tratar a ocultação de painéis de encaixe. Retorne FALSE se desejar impedir que um painel de encaixe seja ocultado.

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

CMDIFrameWndEx::OnCloseMiniFrame

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

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd*);

Parâmetros

pWnd
[in] Ponteiro para a janela de minimoldura que está sendo fechada.

Valor retornado

TRUE se a janela de minimoldura flutuante puder ser fechada. Caso contrário, FALSE.

Comentários

Substitua esse método para tratar a ocultação de janelas de minimolduras flutuantes. Retorne FALSE se desejar impedir que uma janela de minimoldura flutuante seja ocultada.

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

CMDIFrameWndEx::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
[in] Ponteiro para um menu de item pop-up.

Comentários

Substitua esse método se você desejar processar notificações de objetos classe CMFCPopupMenu que pertencem à janela de quadro da MDI quando esses objetos processam mensagens WM_DESTROY.

CMDIFrameWndEx::OnCmdMsg

Chamado pela estrutura para rotear e expedir mensagens de comando e atualizar objetos da interface do usuário de comando.

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

Parâmetros

nID
[in] A ID de comando.

nCode
[in] Identifica o código de notificação de comando. Para obter mais informações sobre valores para nCode, confira CCmdTarget::OnCmdMsg.

pExtra
[in] Usado de acordo com o valor de nCode. Para obter mais informações sobre pExtra, consulte CCmdTarget::OnCmdMsg.

pHandlerInfo
[in, out] Normalmente, esse parâmetro deve ser NULL. Se não for NULL, OnCmdMsg preencherá os membros pTarget e pmf da estrutura pHandlerInfo em vez de expedir o comando.

Valor retornado

Diferente de zero se a mensagem for tratada, caso contrário, 0.

CMDIFrameWndEx::OnDrawMenuImage

Chamado pela estrutura quando a imagem associada a um item de menu é desenhada.

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

Parâmetros

pDC
[in] Ponteiro para um contexto de dispositivo.

pMenuButton
[in] Ponteiro para o botão de menu.

rectImage
[in] Retângulo delimitador da imagem.

Valor retornado

TRUE se o método desenhar a imagem. A implementação padrão retorna FALSE.

Comentários

Substitua esse método se você desejar personalizar a renderização de imagem para os itens de menu que pertencem à barra de menus de propriedade do objeto derivado-CMDIFrameWndEx. A implementação padrão não tem ação.

Chamado pela estrutura quando uma CMFCPopupMenu processa uma mensagem WM_PAINT.

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

Comentários

Substitua essa função para exibir um logotipo no menu de item pop-up que pertence à barra de menus de propriedade do objeto derivado-CMDIFrameWndEx. A implementação padrão não tem ação.

CMDIFrameWndEx::OnEraseMDIClientBackground

Chamado pela estrutura quando a janela de quadros da MDI processa uma mensagem WM_ERASEBKGND.

virtual BOOL OnEraseMDIClientBackground(CDC*);

Valor retornado

TRUE se o aplicativo processar a mensagem e apagar a tela de fundo.

Comentários

Substitua essa função de membro se você desejar processar a mensagem WM_ERASEBKGND em uma classe derivada-CMDIFrameWndEx.

CMDIFrameWndEx::OnMenuButtonToolHitTest

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

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

Parâmetros

pButton
[in] O botão de barra de ferramentas.

pTI
[out] Ponteiro para uma estrutura TOOLINFO.

Valor retornado

TRUE se o aplicativo preencher o parâmetropTI. A implementação padrão retorna FALSE.

Comentários

Substitua esse método se você desejar fornecer informações sobre itens de menu específicos a uma dica de ferramenta. A implementação padrão não tem ação.

CMDIFrameWndEx::OnMoveMiniFrame

Chamado pela estrutura para mover uma janela com minimoldura.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parâmetros

pFrame
[in] Um ponteiro para uma janela com minimoldura.

Valor retornado

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

CMDIFrameWndEx::OnSetPreviewMode

Define o modo de visualização de impressão da janela de quadros principal do aplicativo.

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

Parâmetros

bPreview
[in] Se for TRUE, define o modo de visualização de impressão. Se for FALSE, cancela o modo de visualização.

pState
[in] Um ponteiro para uma estrutura CPrintPreviewState.

Comentários

Este método substitui CFrameWnd::OnSetPreviewMode.

CMDIFrameWndEx::OnShowCustomizePane

Chamado pela estrutura quando um painel de Personalização Rápida é ativado.

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

Parâmetros

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

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

Valor retornado

Esse método sempre retorna TRUE.

Comentários

O painel Personalizar Rápido é um menu que é aberto quando o usuário clica em Personalizar em uma barra de ferramentas.

Substitua esse método em uma classe derivada para fazer alterações no painel Personalizar Rápido.

CMDIFrameWndEx::OnShowMDITabContextMenu

Chamado pela estrutura antes que um menu de atalho seja exibido em uma das guias. Válido somente para grupos com guias da MDI.

virtual BOOL OnShowMDITabContextMenu(
    CPoint point,
    DWORD dwAllowedItems,
    BOOL bTabDrop);

Parâmetros

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

dwAllowedItems
[in] Uma combinação bit a bit "ou" (|) de sinalizadores que indica quais ações são permitidas para a guia atual:

  • AFX_MDI_CREATE_VERT_GROUP - pode criar um grupo de guias vertical.
  • AFX_MDI_CREATE_HORZ_GROUP - pode criar um grupo de guias horizontal.
  • AFX_MDI_CAN_MOVE_PREV - pode mover uma guia para o grupo de guias anterior.
  • AFX_MDI_CAN_MOVE_NEXT - pode mover uma guia para o próximo grupo de guias.
  • AFX_MDI_CAN_BE_DOCKED - alterne um documento com guias para o estado encaixado (relevante somente em documentos com guias).

bTabDrop
[in] TRUE para exibir o menu como resultado de arrastar a guia para outro grupo com guias. FALSE para exibir o menu como um menu de atalho na guia ativa no momento.

Valor retornado

Substitua esse método em uma classe derivada-CMDIFrameWndEx.

Comentários

Se você não processar OnShowMDITabContextMenu, o menu de atalho não será exibido. Essa função é gerada pelo Assistente de Aplicativo MFC quando você habilita o recurso Grupos com guias da MDI.

Exemplo

O exemplo a seguir mostra como OnShowMDITabContextMenu é usado no Exemplo do VisualStudioDemo: aplicativo MFC do Visual Studio.

BOOL CMainFrame::OnShowMDITabContextMenu(CPoint point, DWORD dwAllowedItems, BOOL bDrop)
{
   CMenu menu;
   VERIFY(menu.LoadMenu(bDrop ? IDR_POPUP_DROP_MDITABS : IDR_POPUP_MDITABS));

   CMenu* pPopup = menu.GetSubMenu(0);
   ASSERT(pPopup != NULL);

   if ((dwAllowedItems & AFX_MDI_CREATE_HORZ_GROUP) == 0)
   {
      pPopup->DeleteMenu(ID_MDI_NEW_HORZ_TAB_GROUP, MF_BYCOMMAND);
   }

   if ((dwAllowedItems & AFX_MDI_CREATE_VERT_GROUP) == 0)
   {
      pPopup->DeleteMenu(ID_MDI_NEW_VERT_GROUP, MF_BYCOMMAND);
   }

   if ((dwAllowedItems & AFX_MDI_CAN_MOVE_NEXT) == 0)
   {
      pPopup->DeleteMenu(ID_MDI_MOVE_TO_NEXT_GROUP, MF_BYCOMMAND);
   }

   if ((dwAllowedItems & AFX_MDI_CAN_MOVE_PREV) == 0)
   {
      pPopup->DeleteMenu(ID_MDI_MOVE_TO_PREV_GROUP, MF_BYCOMMAND);
   }

   if ((dwAllowedItems & AFX_MDI_CAN_BE_DOCKED) == 0)
   {
      pPopup->DeleteMenu(ID_MDI_TABBED_DOCUMENT, MF_BYCOMMAND);
   }

   CMFCPopupMenu* pPopupMenu = new CMFCPopupMenu;
   pPopupMenu->SetAutoDestroy(FALSE);
   pPopupMenu->Create(this, point.x, point.y, pPopup->GetSafeHmenu());

   return TRUE;
}

CMDIFrameWndEx::OnShowPanes

Chamado pela estrutura para exibir ou ocultar painéis.

virtual BOOL OnShowPanes(BOOL bShow);

Parâmetros

bShow
[in] TRUE para mostrar painéis, FALSE para ocultar painéis.

Valor retornado

TRUE se o estado dos painéis for alterado como resultado da chamada desse método, FALSE se os painéis já estiverem no estado especificado por bShow. Por exemplo, se os painéis estiverem ocultos e bShow for FALSE, o valor retornado será FALSE.

Comentários

A implementação padrão remove a barra de ferramentas da janela do quadro de nível superior.

Se CDockingManager::m_bHideDockingBarsInContainerMode for TRUE (o padrão), todos os painéis de encaixe serão ocultados.

CMDIFrameWndEx::OnShowPopupMenu

Chamado pela estrutura quando abre um menu de item pop-up.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu*);

Valor retornado

TRUE se o menu de item pop-up for exibido. Caso contrário, FALSE. A implementação padrão retorna TRUE.

Comentários

Substitua esse método se você desejar implementar o processamento especial após a ativação do menu de item pop-up. Por exemplo, se desejar alterar itens de menu normais para botões de menu coloridos, configurar barras destacáveis e assim por diante.

A implementação padrão não tem ação.

CMDIFrameWndEx::OnSizeMDIClient

Chamado pela estrutura quando o tamanho da janela MDI do cliente está sendo alterado.

virtual void OnSizeMDIClient(
    const CRect& rectOld,
    const CRect& rectNew);

Parâmetros

rectOld
[in] O tamanho atual da janela do cliente MDI.

rectNew
[in] O novo tamanho da janela do cliente MDI.

Comentários

CMDIFrameWndEx::OnTearOffMenu

Chamado pela estrutura quando um menu que tem uma barra destacável é ativado.

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

Parâmetros

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

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

Valor retornado

TRUE para permitir que o menu de item pop-up com a barra destacável seja ativado; caso contrário FALSE. O padrão é TRUE.

Comentários

Substitua essa função quando você desejar implementar uma configuração especial para a barra destacável. A implementação padrão não tem ação.

CMDIFrameWndEx::OnUpdateFrameMenu

Chamado pela estrutura para atualizar o menu de quadros.

virtual void OnUpdateFrameMenu(HMENU hMenuAlt);

Parâmetros

hMenuAlt
[in] Um identificador para um menu.

CMDIFrameWndEx::PaneFromPoint

Retorna o painel de encaixe que contém o ponto especificado.

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] Um ponto (em coordenadas da tela).

nSensitivity
[in] O retângulo da janela de cada painel verificado é ampliado em todas as direções por esse valor.

bExactBar
[in] Se for TRUE, o parâmetro nSensitivity é ignorado.

pRTCBarType
[in] Se não for NULL, o método itera somente nos painéis do tipo especificado.

dwAlignment
[out] Se um painel for encontrado, esse parâmetro especificará qual lado do painel está mais próximo do ponto especificado.

Valor retornado

Um ponteiro para um painel de encaixe ou NULL se nenhum controle contiver o ponto especificado por point.

Comentários

A chamada será redirecionada para a classe CDockingManager. Para obter mais informações, consulte CDockingManager::ControlBarFromPoint.

CMDIFrameWndEx::RecalcLayout

Chamado pela estrutura para recalcular o layout da janela de quadros.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parâmetros

bNotify
[in] Determina se o item local ativo para a janela de quadros receberá a notificação da alteração de layout. Se for TRUE, o item será notificado; caso contrário FALSE.

Comentários

Esse método substitui CFrameWnd::RecalcLayout.

CMDIFrameWndEx::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 um painel a ser removido.

bDestroy
[in] TRUE para destruir o painel removido. FALSE para não destruí-lo.

bAdjustLayout
[in] TRUE para ajuste o layout do encaixe imediatamente. Se for FALSE, o ajuste ocorrerá somente quando ocorrer um evento de redesenho por outros motivos (o usuário redimensionar a janela, arrastar o quadro principal etc.).

bAutoHide
[in] TRUE para remover o painel da lista de painéis de ocultamento automático. FALSE para remover o painel da lista de painéis normais.

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

Comentários

Você deve registrar cada painel com o gerenciador de encaixes para fazer parte do layout de encaixe. Usar CMDIFrameWndEx::AddPane ou CMDIFrameWndEx::InsertPane para registrar painéis.

Use esse método quando um painel não fizer mais parte do layout de encaixe da janela de quadros.

CMDIFrameWndEx::SaveMDIState

Salva o layout atual dos Grupos com guias da MDI e a lista dos documentos abertos anteriormente.

virtual BOOL SaveMDIState(LPCTSTR lpszProfileName);

Parâmetros

lpszProfileName
[in] Especifica o nome do perfil.

Valor retornado

TRUE se a operação de salvar foi bem-sucedida; FALSE se a operação de salvar falhou.

Comentários

Para carregar ou salvar o estado das guias e grupos da MDI e a lista de documentos abertos, faça o seguinte:

  • Chamar SaveMDIState quando o quadro principal estiver sendo fechado
  • Chamar CMDIFrameWndEx::LoadMDIState quando o quadro principal estiver sendo criado. O local recomendado para essa chamada é antes que o quadro principal seja exibido pela primeira vez.
  • Chamar CWinAppEx::EnableLoadWindowPlacement(FALSE); antes de pMainFrame->LoadFrame (IDR_MAINFRAME);
  • Chamar CWinAppEx::ReloadWindowPlacement(pMainFrame) depois de LoadMDIState para exibir o quadro principal na posição armazenada no registro.
  • Substitua GetDocumentName na classe derivada-CMDIChildWndEx se o aplicativo exibir documentos que não foram armazenados como arquivos. A cadeia de caracteres retornada será salva no registro como o identificador do documento. Para obter mais informações, consulte CMDIChildWndEx::GetDocumentName.
  • Substitua CMDIFrameWndEx::CreateDocumentWindow para criar documentos corretamente quando eles forem carregados do registro. O parâmetro para CreateDocumentWindow é a cadeia de caracteres que GetDocumentName retornou anteriormente.

Exemplo

O exemplo a seguir mostra como SaveMDIState é usado no Exemplo do VisualStudioDemo: aplicativo MFC do Visual Studio.

void CMainFrame::OnClose()
{
   SaveMDIState(theApp.GetRegSectionPath());
   CMDIFrameWndEx::OnClose();
}

CMDIFrameWndEx::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

CMDIFrameWndEx::SetupToolbarMenu

Modifica um objeto de barra de ferramentas substituindo itens fictícios por itens definidos pelo usuário.

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

Parâmetros

menu
[in] Uma referência a um objeto classe CMenu que será modificado.

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

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

CMDIFrameWndEx::ShowFullScreen

Alterna o quadro principal do modo normal para o modo de tela inteira.

void ShowFullScreen();

Comentários

CMDIFrameWndEx::ShowPane

Mostra ou oculta o painel especificado.

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

Parâmetros

pBar
[in] Ponteiro para o painel que será mostrado ou oculto.

bShow
[in] TRUE para mostrar o painel. FALSE para ocultar o painel.

bDelay
[in] TRUE para atrasar o recálculo do layout de encaixe. FALSE para recalcular o layout de encaixe imediatamente.

bActivate
[in] TRUE para mostrar o painel como ativo. FALSE para mostrar o painel como inativo.

Comentários

Chame esse método para mostrar ou ocultar o painel. Não use ShowWindow para encaixar painéis.

Exemplo

O exemplo a seguir mostra como ShowPane é usado no Exemplo do VisualStudioDemo: aplicativo MFC do Visual Studio.

void COutputList1::OnViewOutput()
{
   CBasePane* pParentBar = DYNAMIC_DOWNCAST(CBasePane, GetOwner());
   CFrameWndEx* pMainFrame = DYNAMIC_DOWNCAST(CFrameWndEx, GetTopLevelFrame());

   if (pMainFrame != NULL && pParentBar != NULL)
   {
      pMainFrame->SetFocus();
      pMainFrame->ShowPane(pParentBar, FALSE, FALSE, FALSE);
   }
}

CMDIFrameWndEx::ShowWindowsDialog

Cria e abre uma caixa CMFCWindowsManagerDialog.

void ShowWindowsDialog();

Exemplo

O exemplo a seguir mostra como ShowWindowsDialog é usado no Exemplo do VisualStudioDemo: aplicativo MFC do Visual Studio.

void CMainFrame::OnWindowManager()
{
   ShowWindowsDialog();
}

CMDIFrameWndEx::TabbedDocumentToControlBar

Converte o documento com guias especificado em um painel de encaixe.

virtual BOOL TabbedDocumentToControlBar(CMDIChildWndEx* pMDIChildWnd);

Parâmetros

pMDIChildWnd
Um ponteiro para a janela filho da MDI que contém um painel de encaixe.

Valor retornado

TRUE se o método foi bem-sucedido e FALSE em caso de falha.

Comentários

Use esse método para converter um documento com guias em um painel de encaixe. O documento com guias deve ter sido criado usando CMDIFrameWndEx::ControlBarToTabbedDocument.

Exemplo

O exemplo a seguir mostra como TabbedDocumentToControlBar é usado no Exemplo do VisualStudioDemo: aplicativo MFC do Visual Studio.

void CMainFrame::OnMdiTabbedDocument()
{
   CMDIChildWndEx* pMDIChild = DYNAMIC_DOWNCAST(CMDIChildWndEx, MDIGetActive());
   if (pMDIChild == NULL)
   {
      ASSERT(FALSE);
      return;
   }

   TabbedDocumentToControlBar(pMDIChild);
}

CMDIFrameWndEx::UpdateCaption

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

void UpdateCaption();

Comentários

CMDIFrameWndEx::UpdateMDITabbedBarsIcons

Define o ícone para cada painel com guias MDI.

void UpdateMDITabbedBarsIcons();

CMDIFrameWndEx::WinHelp

Chamado pela estrutura para iniciar o aplicativo WinHelp ou a ajuda de contexto.

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

Parâmetros

dwData
[in] Especifica os dados conforme necessário para o tipo de ajuda especificado por nCmd.

nCmd
[in] Especifica o tipo de ajuda solicitada. Para obter mais informações sobre os valores possíveis e como eles afetam o parâmetro dwData, confira WinHelp.

Comentários

Este método substitui CWnd::WinHelp.

Confira também

Gráfico da hierarquia
Classes
CMDIFrameWnd classe
CMDIChildWndEx classe