Classe CMFCCustomizeButton

Artigo
08/25/2010

Oferece suporte a um comando de menu ou um botão de barra de ferramentas que inicia uma caixa de diálogo de personalização.

class CMFCCustomizeButton : public CMFCToolBarMenuButton

Membros

Construtores públicos

Nome	Descrição
CMFCCustomizeButton::CMFCCustomizeButton	Constrói um CMFCCustomizeButton objeto.
CMFCCustomizeButton::~CMFCCustomizeButton	Destruidor.

Métodos públicos

Nome	Descrição
CMFCCustomizeButton::AddInvisibleButton	Adiciona um botão à lista de botões invisível na barra de ferramentas pai.
CMFCCustomizeButton::CanBeStored	Determina se o botão pode ser armazenado.
CMFCCustomizeButton::CopyFrom	Copia as propriedades de outro botão de barra de ferramentas do botão corrente.(Substitui CMFCToolBarMenuButton::CopyFrom.)
CMFCCustomizeButton::CreateObject	Usados pela estrutura para criar uma instância desse tipo de classe dinâmica.
CMFCCustomizeButton::CreatePopupMenu	Cria um Personalizar caixa de diálogo.
CMFCCustomizeButton::GetCustomizeCmdId	Recupera a ID de comando personalizado do botão.
CMFCCustomizeButton::GetCustomizeText	Recupera o texto do botão.
CMFCCustomizeButton::GetExtraSize	Recupera o dimensionar extra do botão.
CMFCCustomizeButton::GetInvisibleButtons	Recupera a lista de botões invisível na barra de ferramentas pai.
CMFCCustomizeButton::GetParentToolbar	Recupera a barra de ferramentas do pai do botão.
CMFCCustomizeButton::GetThisClass	Usado pela estrutura para obter um ponteiro para o CRuntimeClass objeto que está associado a este tipo de classe.
CMFCCustomizeButton::InvokeCommand	Lança o WM_COMMAND mensagem para o proprietário da barra de ferramentas do pai do Personalizar botão.
CMFCCustomizeButton::IsDefaultDraw	Determina se o botão é desenhado por padrão.
CMFCCustomizeButton::IsEditable	Determina se o botão é editável.
CMFCCustomizeButton::IsEmptyMenuAllowed	Determina se o botão pode ter um menu pop-up vazio.
CMFCCustomizeButton::IsMenuRightAlign	Indica se o menu é alinhado à direita ou alinhado à esquerda.
CMFCCustomizeButton::IsPipeStyle	Determina se o plano de fundo do botão é desenhado pelo proprietário.
CMFCCustomizeButton::OnCalculateSize	Chamado pela estrutura para calcular o dimensionar do botão para um contexto de dispositivo especificado e o estado de encaixe.(Substitui CMFCToolBarMenuButton::OnCalculateSize.)
CMFCCustomizeButton::OnCancelMode	Chamado pela estrutura para cancelar o nenhum modo interno.(Substitui CMFCToolBarMenuButton::OnCancelMode.)
CMFCCustomizeButton::OnChangeParentWnd	Chamado pela estrutura quando insere um botão em uma nova barra de ferramentas.(Substitui CMFCToolBarMenuButton::OnChangeParentWnd.)
CMFCCustomizeButton::OnDraw	Chamado pela estrutura para desenhar o botão usando estilos especificados e opções.(Substitui CMFCToolBarMenuButton::OnDraw.)
CMFCCustomizeButton::SetDefaultDraw	Especifica se o botão é desenhado por padrão.
CMFCCustomizeButton::SetExtraSize	Especifica o dimensionar extra do botão.
CMFCCustomizeButton::SetMenuRightAlign	Especifica se o menu é alinhado à direita ou alinhado à esquerda.
CMFCCustomizeButton::SetPipeStyle	Especifica se o plano de fundo do botão é desenhado pelo proprietário.

Comentários

Esta classe oferece suporte a infra-estrutura MFC e não se destina a ser usado diretamente em seu código.

A estrutura usa essa classe para exibir a caixa de diálogo de personalização.Para habilitá-lo em seu aplicativo, telefonar o CMFCToolBar::EnableCustomizeButton método.

Para obter mais informações sobre a caixa de diálogo de personalização, consulte Classe CMFCToolBarsCustomizeDialog.

Exemplo

O exemplo a seguir demonstra como recuperar um CMFCCustomizeButton objeto de um CMFCPopupMenu objeto, especificar que o botão é desenhado por padrão, especificar o dimensionar do botão extra, especificar que o menu é alinhado à direita e especificar que o plano de fundo do botão é desenhado pelo proprietário. Neste trecho de código faz parte o Exemplo do CustomPages: Aplicativo do MFC barra de ferramentas personalização Dialog.

        // CMFCPopupMenu* pPopupMenu
        CMFCCustomizeButton* pCustom = (CMFCCustomizeButton*)pPopupMenu->GetParentButton();
        pCustom->SetDefaultDraw(true);
        pCustom->SetExtraSize(10,10);
        pCustom->SetMenuRightAlign(true);
        pCustom->SetPipeStyle(false);