Classe CMFCDropDownFrame

Fornece a funcionalidade de janela do quadro suspenso para as barras de ferramentas suspensas e os botões de barra de ferramentas suspensas.

Sintaxe

class CMFCDropDownFrame : public CMiniFrameWnd

Membros

Construtores públicos

Nome	Descrição
CMFCDropDownFrame::CMFCDropDownFrame	Construtor padrão.
CMFCDropDownFrame::~CMFCDropDownFrame	Destruidor.

Métodos públicos

Nome	Descrição
CMFCDropDownFrame::Create	Cria um objeto CMFCDropDownFrame.
CMFCDropDownFrame::CreateObject	Usado pela estrutura para criar uma instância dinâmica desse tipo de classe.
CMFCDropDownFrame::GetParentMenuBar	Recupera a barra de menus pai do quadro suspenso.
CMFCDropDownFrame::GetParentPopupMenu	Recupera o menu pop-up pai do quadro suspenso.
CMFCDropDownFrame::GetThisClass	Usado pela estrutura para obter um ponteiro para o objeto CRuntimeClass associado a esse tipo de classe.
CMFCDropDownFrame::RecalcLayout	Reposiciona o quadro suspenso.
CMFCDropDownFrame::SetAutoDestroy	Define se a janela de barra de ferramentas suspensa filho será destruída automaticamente.

Comentários

Essa classe não se destina a ser usada diretamente do seu código.

A estrutura usa essa classe para fornecer o comportamento do quadro para as classes CMFCDropDownToolbar e CMFCDropDownToolbarButton. Para obter mais informações sobre essas classes, consulte Classe CMFCDropDownToolBar e Classe CMFCDropDownToolbarButton.

Exemplo

O exemplo a seguir demonstra como recuperar um ponteiro para um objeto CMFCDropDownFrame de uma classe CFrameWnd e como definir a janela de barra de ferramentas suspensa filho para ser destruída automaticamente.

CFrameWnd *pTopFrame = AFXGetParentFrame(this);
if (pTopFrame == NULL)
{
   return FALSE;
}

CMFCDropDownFrame *pDropFrame = DYNAMIC_DOWNCAST(CMFCDropDownFrame, pTopFrame);
pDropFrame->SetAutoDestroy(true);

Hierarquia de herança

CObject

CCmdTarget

CWnd

CFrameWnd

CMiniFrameWnd

CMFCDropDownFrame

Requisitos

Cabeçalho: afxdropdowntoolbar.h

CMFCDropDownFrame::Create

Cria um objeto CMFCDropDownFrame.

virtual BOOL Create(
    CWnd* pWndParent,
    int x,
    int y,
    CMFCDropDownToolBar* pWndOriginToolbar);

Parâmetros

pWndParent
[in] A janela pai do quadro suspenso.

x
[in] A coordenada horizontal da tela para o local do quadro suspenso.

y
[in] A coordenada vertical da tela para o local do quadro suspenso.

pWndOriginToolbar
[in] A barra de ferramentas que possui os botões suspensos que esse método usa para preencher o novo objeto de quadro suspenso.

Valor de retorno

TRUE se o quadro suspenso foi criado com êxito, caso contrário, FALSE.

Comentários

Esse método chama o método CMiniFrameWnd::CreateEx base para criar a janela de quadro suspenso com o estilo WS_POPUP. A janela do quadro suspenso aparece nas coordenadas da tela especificadas. Esse método falhará se o método CMiniFrameWnd::CreateEx retornar FALSE.

A classe CMFCDropDownFrame cria uma cópia do parâmetro CMFCDropDownToolBar fornecido. Esse método copia as imagens de botão e os estados de botão do parâmetro pWndOriginToolbar para o membro de dados m_pWndOriginToolbar.

CMFCDropDownFrame::GetParentMenuBar

Recupera a barra de menus pai do quadro suspenso.

CMFCMenuBar* GetParentMenuBar() const;

Valor de retorno

Um ponteiro para a barra de menus pai do quadro suspenso ou NULL se o quadro não tiver pai.

Comentários

Esse método recupera a barra de menus pai do botão pai. Esse método retornará NULL se o quadro suspenso não tiver um botão pai ou se o botão pai não tiver nenhuma barra de menus pai.

CMFCDropDownFrame::GetParentPopupMenu

Recupera o menu pop-up pai do quadro suspenso.

CMFCDropDownFrame* GetParentPopupMenu() const;

Valor de retorno

Um ponteiro para o menu suspenso pai do quadro suspenso ou NULL se o quadro não tiver pai.

Comentários

Esse método recupera o menu pai do botão pai. Este método retornará NULL se o quadro suspenso não tiver um botão pai ou se o botão pai não tiver um menu pai.

CMFCDropDownFrame::RecalcLayout

Reposiciona o quadro suspenso.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parâmetros

bNotify
[in] Não é usado.

Comentários

A estrutura chamará esse método quando o quadro suspenso for criado ou a janela pai for redimensionada. Esse método calcula a posição e o tamanho do quadro suspenso usando a posição e o tamanho da janela pai.

CMFCDropDownFrame::SetAutoDestroy

Define se a janela de barra de ferramentas suspensa filho será destruída automaticamente.

void SetAutoDestroy(BOOL bAutoDestroy = TRUE);

Parâmetros

bAutoDestroy
[in] TRUE para destruir automaticamente a janela de barra de ferramentas suspensa associada, caso contrário, FALSE.

Comentários

Se bAutoDestroy for TRUE, o destruidor CMFCDropDownFrame destruirá a janela de barra de ferramentas suspensa associada. O valor padrão é TRUE.

Confira também

Gráfico da hierarquia
Classes
Classe CMFCDropDownToolBar
Classe CMFCDropDownToolbarButton