Classe CMDIChildWndEx

A classe CMDIChildWndEx fornece a funcionalidade de uma janela filho do Windows multiple document interface (MDI). Ele estende a funcionalidade de CMDIChildWnd Class. A estrutura requer essa classe quando um aplicativo MDI usa determinadas classes MFC.

Para obter mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da instalação do Visual Studio.

Sintaxe

class CMDIChildWndEx : public CMDIChildWnd

Membros

Métodos Públicos

Comentários

Para aproveitar os recursos de encaixe estendidos em aplicativos MDI, derive a classe de janela filho MDI do seu aplicativo de CMDIChildWndEx em vez de CMDIChildWnd.

Exemplo

O exemplo a seguir deriva uma classe de CMDIChildWndEx. Este trecho de código vem do VisualStudioDemo Sample: MFC Visual Studio Application.

class CChildFrame : public CMDIChildWndEx
{
   DECLARE_DYNCREATE(CChildFrame)
public:
   CChildFrame();

   // Overrides
public:
   virtual BOOL PreCreateWindow(CREATESTRUCT &cs);
   virtual void ActivateFrame(int nCmdShow = -1);

   virtual BOOL IsReadOnly();
   virtual LPCTSTR GetDocumentName(CObject **pObj);

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

protected:
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

   DECLARE_MESSAGE_MAP()
};

Hierarquia de herança

CObject

CCmdTarget

CWnd

CFrameWnd

CMDIChildWnd

CMDIChildWndEx

Requerimentos

Cabeçalho: afxMDIChildWndEx.h

CMDIChildWndEx::AddPane

Adiciona um painel.

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

Parâmetros

pControlBar
[em] Um ponteiro para o painel.

bTail
[em] TRUE para adicionar o painel ao final da lista de painéis para o gerenciador de encaixe; caso contrário, FALSE.

Valor de retorno

TRUE se o painel foi registrado com sucesso no gerenciador de ancoragem; caso contrário, FALSE.

CMDIChildWndEx::AddTabbedPane

Adiciona um painel com guias.

void AddTabbedPane(CDockablePane* pControlBar);

Parâmetros

pControlBar
[em] Um ponteiro para o painel.

CMDIChildWndEx::AdjustDockingLayout

Ajusta o layout de encaixe.

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

Parâmetros

hdwp
[em] Manipule uma estrutura de posição de janela adiada.

CMDIChildWndEx::CanShowOnMDITabs

virtual BOOL CanShowOnMDITabs();

Valor de retorno

Comentários

CMDIChildWndEx::CanShowOnWindowsList

Especifica se o nome da janela filho MDI pode ser exibido na caixa de diálogo CMFCWindowsManagerDialog Class.

virtual BOOL CanShowOnWindowsList();

Valor de retorno

TRUE se a janela puder ser exibida na caixa de diálogo Windows; caso contrário, FALSE.

Comentários

Substitua esse método em uma classe derivada e retorne FALSE se a janela não deve ser exibida na caixa de diálogo Windows. Esta função é chamada a partir de CMFCWindowsManagerDialog.

CMDIChildWndEx::D ockPane

Encaixa um painel.

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

Parâmetros

pBar
[em] Um ponteiro para o painel.

nDockBarID
[em] A ID do painel.

lpRect
[em] Um ponteiro para um retângulo.

Comentários

O parâmetro lpRect não é usado.

CMDIChildWndEx::D ockPaneLeftOf

Encaixa um painel à esquerda de outro.

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

Parâmetros

pBar
Um ponteiro para o painel que deve ser encaixado.

pLeftOf
Um ponteiro para o painel que serve como ponto de referência.

Valor de retorno

VERDADEIRO no sucesso, FALSO no fracasso.

Comentários

Esse método pega o painel especificado por pBar e encaixa-o no lado esquerdo do painel especificado por pLeftOf.

Chame esse método quando quiser encaixar vários painéis em ordem predefinida.

CMDIChildWndEx::EnableAutoHidePanes

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

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parâmetros

dwDockStyle
[em] Especifica os lados da janela do quadro principal que está habilitada. Use um ou mais dos seguintes sinalizadores.

• CBRS_ALIGN_LEFT

• CBRS_ALIGN_RIGHT

• CBRS_ALIGN_TOP

• CBRS_ALIGN_BOTTOM

Valor de retorno

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

CMDIChildWndEx::EnableDocking

Permite encaixar a janela filho no quadro principal.

BOOL EnableDocking(DWORD dwDockStyle);

Parâmetros

dwDockStyle
[em] Especifica o alinhamento de encaixe a ser habilitado.

Valor de retorno

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

Comentários

Chame esse método para habilitar o alinhamento de encaixe no quadro principal. Você pode passar uma combinação de CBRS_ALIGN_ sinalizadores (para obter mais informações, consulte CControlBar::EnableDocking).

CMDIChildWndEx::GetDockingManager

CDockingManager* GetDockingManager();

Valor de retorno

Comentários

CMDIChildWndEx::GetDocumentName

Retorna o nome do documento exibido na janela filho MDI.

virtual LPCTSTR GetDocumentName(CObject** pObj);

Valor de retorno

Um ponteiro para uma cadeia de caracteres que contém o nome de um documento.

Comentários

Um documento é o que a janela filho MDI exibe. Geralmente, a janela exibe dados que são carregados ou salvos em um arquivo. Portanto, o nome do documento é o nome do arquivo. A implementação padrão de GetDocumentName retorna uma cadeia de caracteres obtida de CDocument::GetPathName.

Se a janela exibir um documento que não é carregado de um arquivo, substitua esse método em uma classe derivada e retorne um identificador de documento exclusivo.

GetDocumentName é chamado pela estrutura quando salva o estado de todos os documentos abertos. A cadeia de caracteres retornada é gravada no registro.

Quando a estrutura está restaurando o estado mais tarde, o nome do documento é lido do registro e passado para CMDIFrameWndEx::CreateDocumentWindow. Substitua esse método em um CMDIFrameWndExclasse derivada e crie ou abra um documento que tenha esse nome e leia no arquivo que tem esse nome. Se o documento não se basear num ficheiro, crie o documento com base no próprio identificador do documento. Você deve executar as ações anteriores somente se pretender salvar e restaurar documentos.

Exemplo

O exemplo a seguir demonstra o uso do GetDocumentName método. Este trecho de código vem do VisualStudioDemo Sample: MFC Visual Studio Application.

LPCTSTR CChildFrame::GetDocumentName(CObject **pObj)
{
   if (DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL)
   {
      return g_strStartViewName;
   }
   return CMDIChildWndEx::GetDocumentName(pObj);
}

CMDIChildWndEx::GetFrameIcon

Chamado pela estrutura para recuperar o ícone da janela filho MDI.

virtual HICON GetFrameIcon() const;

Valor de retorno

Uma alça para o ícone da janela.

Comentários

Esse método é chamado pela estrutura para determinar qual ícone exibir na guia MDI que contém a janela de quadro filho MDI.

Por padrão, esse método retorna o ícone da janela. Substitua GetFrameIcon em uma classe derivada do CMDIChildWndExpara personalizar esse comportamento.

CMDIChildWndEx::GetFrameText

Chamado pela estrutura para recuperar o texto para a janela filho MDI.

virtual CString GetFrameText() const;

Valor de retorno

Uma cadeia de caracteres que contém o texto da janela do quadro.

Comentários

Esse método é chamado pela estrutura para determinar qual texto exibir na guia MDI que contém a janela de quadro filho MDI.

Por padrão, esse método retorna o texto da janela. Substitua GetFrameText em uma classe derivada do CMDIChildWndExpara personalizar esse comportamento.

CMDIChildWndEx::GetPane

Localiza um painel pela ID de controle especificada.

CBasePane* GetPane(UINT nID);

Parâmetros

nID
[em] A ID de controle do painel a ser localizada.

Valor de retorno

Um ponteiro para o painel, se encontrado, caso contrário, NULL.

CMDIChildWndEx::GetRelatedTabGroup

CMFCTabCtrl* GetRelatedTabGroup();

Valor de retorno

Comentários

CMDIChildWndEx::GetTabbedPane

Retorna um ponteiro para um painel de encaixe que faz parte de um grupo de documentos com guias MDI.

CDockablePane* GetTabbedPane() const;

Valor de retorno

Um ponteiro para um painel de encaixe que faz parte de um grupo de documentos com guias MDI.

CMDIChildWndEx::GetToolbarButtonToolTipText

Chamado pela estrutura para recuperar uma dica de ferramenta para um botão da barra de ferramentas.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton*,
    CString&);

Valor de retorno

TRUE se a dica de ferramenta tiver sido exibida. A implementação padrão retorna FALSE.

Comentários

Substitua esse método se quiser exibir dicas de ferramentas personalizadas para botões da barra de ferramentas.

CMDIChildWndEx::InsertPane

Registra o painel especificado com o gerenciador de encaixe.

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

Parâmetros

pControlBar
[em] Um ponteiro para o painel a ser inserido.

pTarget
[em] Um ponteiro para o painel adjacente.

bDepois
[em] Se TRUE, pControlBar é inserido após pTarget. Se FALSE, pControlBar é inserido antes de pTarget.

Valor de retorno

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

CMDIChildWndEx::IsPointNearDockSite

Determina se um ponto especificado está perto do local da doca.

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

Parâmetros

ponto
[em] O ponto especificado.

dwBarAlignment
[em] Especifica 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
[em] VERDADEIRO se o ponto estiver próximo da borda externa do local do cais; FALSO caso contrário.

Valor de retorno

TRUE se o ponto estiver perto do local da doca; caso contrário, FALSE.

Comentários

O ponto está perto do local da doca quando está dentro da sensibilidade definida no gerenciador de ancoragem. A sensibilidade padrão é de 15 pixels.

CMDIChildWndEx::IsReadOnly

Especifica se o documento exibido na janela filho é somente leitura.

virtual BOOL IsReadOnly();

Valor de retorno

TRUE se o documento for somente leitura; caso contrário, FALSE.

Comentários

Esta função é usada para evitar o salvamento de documentos somente leitura.

Exemplo

O exemplo a seguir demonstra a substituição do método IsReadOnly. Este trecho de código vem do VisualStudioDemo Sample: MFC Visual Studio Application.

BOOL CChildFrame::IsReadOnly()
{
   return DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL;
}

CMDIChildWndEx::IsTabbedPane

Especifica se a janela filho MDI contém um painel de encaixe.

BOOL IsTabbedPane() const;

Valor de retorno

TRUE se a janela filho MDI contiver um painel de encaixe que foi convertido em um documento com guias; caso contrário, FALSE.

CMDIChildWndEx::OnMoveMiniFrame

Chamado pela estrutura para mover uma janela de miniquadro.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parâmetros

pFrame
[em] Um ponteiro para uma janela de miniquadro.

Valor de retorno

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

CMDIChildWndEx::OnSetPreviewMode

Chamado pela estrutura para entrar ou sair do modo de visualização de impressão.

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

Parâmetros

bPreview
[em] Se TRUE, entre no modo de visualização de impressão. Se FALSE, saia do modo de visualização de impressão.

pState
[em] Um ponteiro para a estrutura de estado de visualização de impressão.

CMDIChildWndEx::OnUpdateFrameTitle

Chamado pela estrutura para atualizar o título do quadro.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Parâmetros

bAddToTitle
[em] Se TRUE, adicione o nome do documento ao título.

CMDIChildWndEx::P aneFromPoint

Retorna o painel que contém o 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

ponto
[em] Especifica o ponto, em coordenadas de tela, a ser verificado.

nSensibilidade
[em] Aumente a área de pesquisa neste montante. Um painel satisfaz os critérios de pesquisa se o ponto dado cair na área aumentada.

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

pRTCBarType
[em] Se não for NULL, o método pesquisa apenas painéis do tipo especificado.

dwAlignment
[em] Se um painel for encontrado no ponto especificado, esse parâmetro conterá o lado do painel mais próximo do ponto especificado. Para obter mais informações, consulte a seção Observações.

Valor de retorno

Um ponteiro para o objeto derivado de CBasePaneque contém o ponto determinado, ou NULL se nenhum painel foi encontrado.

Comentários

Chame esse método para determinar se um painel contém o ponto especificado de acordo com as condições especificadas, como classe de tempo de execução e visibilidade.

Quando a função retorna e um painel foi encontrado, dwAlignment contém o alinhamento do ponto especificado. Por exemplo, se o ponto estiver mais próximo da parte superior do painel, dwAlignment será definido como CBRS_ALIGN_TOP.

CMDIChildWndEx::RecalcLayout

Recalcula o layout da janela.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parâmetros

bNotificar
[em] Se TRUE, o item in-loco ativo para a janela recebe notificação da alteração de layout.

CMDIChildWndEx::RemovePaneFromDockManager

Remove um painel do gerenciador de encaixe.

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

Parâmetros

pControlBar
[em] Um ponteiro para o painel a ser removido.

bDestruir
[em] Se TRUE, o painel removido será destruído.

bAdjustLayout
[em] Se VERDADEIRO, ajuste o layout de encaixe imediatamente.

bAutoHide
[em] Se TRUE, o layout de encaixe está relacionado à lista de barras de ocultação automática. Se FALSE, o layout de encaixe está relacionado à lista de painéis regulares.

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

CMDIChildWndEx::SetRelatedTabGroup

void SetRelatedTabGroup(CMFCTabCtrl* p);

Parâmetros

[em] p

Comentários

CMDIChildWndEx::ShowPane

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

Parâmetros

[em] pBar

[em] bShow

[em] bDelay

[em] bActivate

Comentários

CMDIChildWndEx::UpdateTaskbarTabIcon

Atualiza o ícone da guia da barra de tarefas do Windows 7.

virtual void UpdateTaskbarTabIcon(HICON hIcon);

Parâmetros

hIcon
Um identificador para um ícone a ser exibido na guia da barra de tarefas do Windows 7.

Comentários

CMDIChildWndEx::UnregisterTaskbarTab

Remove o filho MDI das guias da barra de tarefas do Windows 7.

void UnregisterTaskbarTab(BOOL bCheckRegisteredMDIChildCount = TRUE);

Parâmetros

bCheckRegisteredMDIChildCount
Especifica se essa função precisa verificar o número de filhos MDI registrados com guias MDI. Se esse número for 0, essa função removerá o retângulo de recorte da miniatura da barra de tarefas do aplicativo.

Comentários

CMDIChildWndEx::SetTaskbarThumbnailClipRect

Chamado pela estrutura para definir o retângulo de recorte para selecionar uma parte da área do cliente de uma janela para exibir como miniatura dessa janela na barra de tarefas.

virtual BOOL SetTaskbarThumbnailClipRect(CRect rect);

Parâmetros

rect
Especifica o novo retângulo de recorte. Se o retângulo estiver vazio ou nulo, o recorte será removido.

Valor de retorno

VERDADEIRO se bem sucedido; caso contrário, FALSE.

Comentários

CMDIChildWndEx::SetTaskbarTabProperties

Define propriedades para uma guia da barra de tarefas do Windows 7.

void SetTaskbarTabProperties(DWORD dwFlags);

Parâmetros

dwFlags
Uma combinação de valores STPFLAG. Para obter mais informações, consulte ITaskbarList4::SetTabProperties.

Comentários

CMDIChildWndEx::SetTaskbarTabOrder

Insere o filho MDI antes da janela especificada nas guias da barra de tarefas do Windows 7.

void SetTaskbarTabOrder(CMDIChildWndEx* pWndBefore = NULL);

Parâmetros

pWndBefore
Um ponteiro para a janela filho MDI cuja miniatura é inserida à esquerda. Esta janela já deve ser registada através RegisterTaskbarTab. Se esse valor for NULL, a nova miniatura será adicionada ao final da lista.

Comentários

CMDIChildWndEx::SetTaskbarTabActive

Ativa a guia correspondente da barra de tarefas do Windows 7.

void SetTaskbarTabActive();

Comentários

CMDIChildWndEx::RegisterTaskbarTab

Registra o filho MDI com guias da barra de tarefas do Windows 7.

virtual void RegisterTaskbarTab(CMDIChildWndEx* pWndBefore = NULL);

Parâmetros

pWndBefore
Um ponteiro para a janela filho MDI cuja miniatura é inserida à esquerda. Esta janela já deve ser registada através RegisterTaskbarTab. Se esse valor for NULL, a nova miniatura será adicionada ao final da lista.

Comentários

CMDIChildWndEx::OnTaskbarTabThumbnailStretch

Chamado pela estrutura quando precisa esticar um bitmap para uma visualização em miniatura da guia da barra de tarefas do Windows 7 do filho MDI.

virtual BOOL OnTaskbarTabThumbnailStretch(
    HBITMAP hBmpDst,
    const CRect& rectDst,
    HBITMAP hBmpSrc,
    const CRect& rectSrc);

Parâmetros

hBmpDst
Um identificador para um bitmap de destino.

rectDst
Especifica o retângulo de destino.

hBmpSrc
Um identificador para um bitmap de origem.

rectSrc
Especifica o retângulo de origem.

Comentários

Exigência: afxmdichildwndex.h

CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate

Chamado pela estrutura quando a miniatura da guia Barra de tarefas deve processar a mensagem WM_MOUSEACTIVATE.

virtual int OnTaskbarTabThumbnailMouseActivate(
    CWnd* pDesktopWnd,
    UINT nHitTest,
    UINT message);

Parâmetros

pDesktopWnd
Especifica um ponteiro para a janela pai de nível superior da janela que está sendo ativada. O ponteiro pode ser temporário e não deve ser armazenado.

nHitTest
Especifica o código de área de teste de acerto. Um teste de acerto é um teste que determina a localização do cursor.

mensagem
Especifica o número da mensagem do mouse.

Comentários

A implementação padrão ativa o quadro filho MDI relacionado.

CMDIChildWndEx::OnTaskbarTabThumbnailActivate

Chamado pela estrutura quando a miniatura da guia Barra de tarefas deve processar a mensagem WM_ACTIVATE.

virtual void OnTaskbarTabThumbnailActivate(
    UINT nState,
    CWnd* pWndOther,
    BOOL bMinimized);

Parâmetros

nState
Especifica se o CWnd está sendo ativado ou desativado.

pWndOutros
Ponteiro para o CWnd que está sendo ativado ou desativado. O ponteiro pode ser NULL e pode ser temporário.

b minimizado
Especifica o estado minimizado do CWnd que está sendo ativado ou desativado. Um valor TRUE indica que a janela está minimizada.

Comentários

A implementação padrão ativa o quadro filho MDI relacionado.

CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton

Chamado pela estrutura quando o usuário pressiona o botão fechar na miniatura da guia Barra de tarefas.

virtual void OnPressTaskbarThmbnailCloseButton();

Comentários

CMDIChildWndEx::OnGetIconicThumbnail

Chamado pela estrutura quando precisa obter um bitmap para a miniatura icônica do filho MDI.

virtual HBITMAP OnGetIconicThumbnail(
    int nWidth,
    int nHeight);

Parâmetros

nWidth
Especifica a largura do bitmap necessário.

nAltura
Especifica a altura do bitmap necessário.

Comentários

CMDIChildWndEx::OnGetIconicLivePreviewBitmap

Chamado pela estrutura quando ele precisa obter um bitmap para visualização ao vivo do filho MDI.

virtual HBITMAP OnGetIconicLivePreviewBitmap(
    BOOL bIsMDIChildActive,
    CPoint& ptLocation);

Parâmetros

bIsMDIChildActive
Esse parâmetro será TRUE se o bitmap for solicitado para o filho MDI, que está ativo no momento e a janela principal não é minimizada. O processamento padrão, neste caso, tira um instantâneo da janela principal.

ptLocalização
Especifica o local do bitmap nas coordenadas do cliente da janela principal (nível superior). Este ponto deve ser fornecido pelo destinatário.

Valor de retorno

Se processado, retorna um identificador para um bitmap válido de 32bpp, caso contrário, NULL.

Comentários

Substitua esse método em uma classe derivada e retorne um bitmap válido de 32bpp para visualização ao vivo do filho MDI. Este método é chamado somente quando o filho MDI é exibido nas guias da barra de tarefas do Windows 7. Se você retornar NULL, MFC chamará os manipuladores padrão e obterá bitmaps usando PrintClient ou PrintWindow.

CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags

Uma combinação de sinalizadores, que é passada pela estrutura para o método SetTaskbarTabProperties, quando uma guia (filho MDI) está sendo registrada com guias da barra de tarefas do Windows 7.

AFX_IMPORT_DATA static DWORD m_dwDefaultTaskbarTabPropertyFlags;

Comentários

A combinação padrão é STPF_USEAPPTHUMBNAILWHENACTIVE | STPF_USEAPPPEEKWHENACTIVE.

CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled

Informa se a seleção automática de uma parte da área do cliente de uma janela a ser exibida como miniatura dessa janela na barra de tarefas está habilitada ou desabilitada.

BOOL IsTaskbarThumbnailClipRectEnabled() const;

Valor de retorno

Retorna TRUE se a seleção automática de uma parte da área do cliente de uma janela para exibição estiver ativada; caso contrário, FALSE.

Comentários

CMDIChildWndEx::IsTaskbarTabsSupportEnabled

Informa se o filho MDI pode aparecer nas guias da barra de tarefas do Windows 7.

BOOL IsTaskbarTabsSupportEnabled();

Valor de retorno

TRUE se o filho MDI pode aparecer nas guias da barra de tarefas do Windows 7; FALSO se o filho MDI não puder aparecer nas guias da barra de tarefas do Windows 7.

Comentários

CMDIChildWndEx::IsRegisteredWithTaskbarTabs

Retorna TRUE se o filho MDI foi registrado com êxito com guias da barra de tarefas do Windows 7.

BOOL IsRegisteredWithTaskbarTabs();

Valor de retorno

TRUE se o filho MDI estiver registrado com as guias da barra de tarefas do Windows 7; caso contrário, FALSE.

Comentários

CMDIChildWndEx::InvalidateIconicBitmaps

Invalida uma representação de bitmap icônica de um filho MDI.

BOOL InvalidateIconicBitmaps();

Valor de retorno

Devolve FALSO se o suporte da barra de tarefas do Windows 7 estiver desativado ou se o filho MDI não estiver registado nos separadores da barra de tarefas do Windows 7; caso contrário, retorna TRUE.

Comentários

Deve ser chamado quando o conteúdo ao vivo ou o tamanho de um filho MDI tiver sido alterado.

CMDIChildWndEx::GetTaskbarThumbnailClipRect

Chamado pela estrutura quando precisa selecionar uma parte da área do cliente de uma janela para exibir como miniatura dessa janela na barra de tarefas.

virtual CRect GetTaskbarThumbnailClipRect() const;

Valor de retorno

Um retângulo nas coordenadas das janelas. Este retângulo é mapeado para a área do cliente do quadro de nível superior. O retângulo deve estar vazio para limpar o retângulo de corte.

Comentários

CMDIChildWndEx::GetTaskbarPreviewWnd

Chamado pela estrutura quando precisa obter uma janela filho (geralmente uma janela de exibição ou divisor) para ser exibida em uma miniatura de guia da barra de tarefas do Windows 7.

virtual CWnd* GetTaskbarPreviewWnd();

Valor de retorno

Deve retornar um ponteiro válido para um objeto CWnd, cuja visualização deve ser exibida em uma guia da barra de tarefas do Windows 7 relacionada a esse filho MDI. A implementação padrão retorna uma janela filho desse filho MDI com AFX_IDW_PANE_FIRST ID de controle (que geralmente é uma classe derivada do CView).

Comentários

CMDIChildWndEx::GetTabProxyWnd

Retorna a janela de proxy de guia registrada com guias da barra de tarefas do Windows 7.

CMDITabProxyWnd* GetTabProxyWnd();

Valor de retorno

Um ponteiro para um objeto CMDITabProxyWnd, que está registrado com guias da barra de tarefas do Windows 7.

Comentários

CMDIChildWndEx::EnableTaskbarThumbnailClipRect

Habilita ou desabilita a seleção automática de uma parte da área do cliente de uma janela para exibição como miniatura dessa janela na barra de tarefas.

void EnableTaskbarThumbnailClipRect(BOOL bEnable = TRUE);

Parâmetros

bAtivar
Especifica se a seleção automática de uma parte da área do cliente de uma janela deve ser habilitada ou desabilitada (TRUE) para exibição.

Comentários

CMDIChildWndEx::CanShowOnTaskBarTabs

Informa à estrutura se esse filho MDI pode ser exibido nas guias da barra de tarefas do Windows 7.

virtual BOOL CanShowOnTaskBarTabs();

Valor de retorno

TRUE se o conteúdo do filho MDI puder ser exibido nas miniaturas da barra de tarefas do Windows 7.

Comentários

Substitua esse método em uma classe derivada e retorne FALSE para desabilitar a aparência desse filho MDI nas guias da barra de tarefas do Windows 7.

CMDIChildWndEx::ActivateTopLevelFrame

Chamado pela estrutura para ativar o quadro de nível superior quando o aplicativo é ativado a partir de uma guia da barra de tarefas.

virtual void ActivateTopLevelFrame();

Comentários

Ver também

Gráfico de Hierarquia
Aulas
CMDIChildWnd Classe
CMFCWindowsManagerDialog Classe
CMDIFrameWndEx Classe