Compartilhar via


Classe CMFCRibbonButtonsGroup

A classe CMFCRibbonButtonsGroup permite que você organize um conjunto de botões de faixa de opções em um grupo. Todos os botões no grupo são diretamente adjacentes uns aos outros na horizontal e colocados em uma borda.

Sintaxe

class CMFCRibbonButtonsGroup : public CMFCRibbonBaseElement

Membros

Construtores públicos

Nome Descrição
CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup Constrói um objeto CMFCRibbonButtonsGroup.

Métodos públicos

Nome Descrição
CMFCRibbonButtonsGroup::AddButton Adiciona um botão a um grupo.
CMFCRibbonButtonsGroup::AddButtons Adiciona uma lista de botões a um grupo.
CMFCRibbonButtonsGroup::GetButton Retorna um ponteiro para o botão localizado em um índice especificado.
CMFCRibbonButtonsGroup::GetCount Retorna o número de botões no grupo.
CMFCRibbonButtonsGroup::GetImageSize Retorna o tamanho das imagens normais no grupo da faixa de opções (substitui CMFCRibbonBaseElement::GetImageSize.)
CMFCRibbonButtonsGroup::GetRegularSize Retorna o tamanho regular do elemento da faixa de opções (substitui CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonButtonsGroup::HasImages Relata se o objeto CMFCRibbonButtonsGroup contém imagens da barra de ferramentas.
CMFCRibbonButtonsGroup::OnDrawImage Desenha a imagem apropriada de um botão especificado, dependendo de o botão estar normal, realçado ou desabilitado.
CMFCRibbonButtonsGroup::RemoveAll Remove todos os botões do objeto CMFCRibbonButtonsGroup.
CMFCRibbonButtonsGroup::SetImages Atribui imagens ao grupo.
CMFCRibbonButtonsGroup::SetParentCategory Define o CMFCRibbonCategory pai do objeto CMFCRibbonButtonsGroup e todos os botões dentro dele (substitui CMFCRibbonBaseElement::SetParentCategory.)

Comentários

O grupo é derivado de CMFCBaseRibbonElement e pode ser manipulado como uma só entidade. Você pode posicionar o grupo em qualquer painel ou menu pop-up.

Exemplo

O exemplo a seguir demonstra como usar vários métodos na classe CMFCRibbonButtonsGroup. O exemplo mostra como construir um objeto CMFCRibbonButtonsGroup, atribuir imagens ao grupo de botões da faixa de opções e adicionar um botão ao grupo de botões da faixa de opções. Esse snippet de código faz parte do exemplo Desenhar Cliente.

CMFCRibbonButtonsGroup *pSBGroup = new CMFCRibbonButtonsGroup;

CMFCToolBarImages images;
images.SetImageSize(CSize(14, 14));

CMFCToolBarImages hotimages;
hotimages.SetImageSize(CSize(14, 14));

if (images.Load(IDB_STATUSBAR_1) && hotimages.Load(IDB_STATUSBAR_2))
{
   pSBGroup->SetImages(&images, &hotimages, NULL);
}

pSBGroup->AddButton(new CMFCRibbonButton(ID_FILE_PRINT_PREVIEW, _T(""), 0));
pSBGroup->AddButton(new CMFCRibbonButton(ID_FILE_SUMMARYINFO, _T(""), 1));

// CMFCRibbonStatusBar m_wndStatusBar
m_wndStatusBar.AddExtendedElement(pSBGroup, _T("View Shortcuts"));

Hierarquia de herança

CObject

CMFCRibbonBaseElement

CMFCRibbonButtonsGroup

Requisitos

Cabeçalho: afxribbonbuttonsgroup.h

CMFCRibbonButtonsGroup::AddButton

Adiciona um botão a um grupo.

void AddButton(CMFCRibbonBaseElement* pButton);

Parâmetros

pButton
[in] Um ponteiro para um botão a ser adicionado.

CMFCRibbonButtonsGroup::AddButtons

Adiciona uma lista de botões a um grupo.

void AddButtons(
    const CList<CMFCRibbonBaseElement*,CMFCRibbonBaseElement*>& lstButtons);

Parâmetros

lstButtons
[in] Uma lista de ponteiros para os botões que você deseja adicionar.

CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup

Constrói um objeto CMFCRibbonButtonsGroup.

CMFCRibbonButtonsGroup();
CMFCRibbonButtonsGroup(CMFCRibbonBaseElement* pButton);

Parâmetros

pButton
[in] Especifica um botão a ser adicionado ao objeto CMFCRibbonButtonsGroup recém-criado.

Valor de retorno

Comentários

CMFCRibbonButtonsGroup::GetButton

Retorna um ponteiro para o botão localizado em um índice especificado.

CMFCRibbonBaseElement* GetButton(int i) const;

Parâmetros

i
[in] Um índice baseado em zero de um botão a ser retornado.

Valor de retorno

Um ponteiro para o botão localizado no índice especificado. NULL se o índice especificado estiver fora do intervalo.

Comentários

CMFCRibbonButtonsGroup::GetCount

Retorna o número de botões no grupo.

int GetCount() const;

Valor de retorno

O número de botões no grupo.

CMFCRibbonButtonsGroup::GetImageSize

Recupera o tamanho da imagem de origem do membro protegido CMFCToolBarImages m_Images.

const CSize GetImageSize() const;

Valor de retorno

Retornará o tamanho da imagem de origem das imagens da barra de ferramentas, se houver alguma, ou um CSize igual a zero se não houver.

Comentários

CMFCRibbonButtonsGroup::GetRegularSize

Recupera o tamanho máximo possível do elemento de grupo da faixa de opções.

virtual CSize GetRegularSize(CDC* pDC);

Parâmetros

pDC
[in] Ponteiro para o contexto do grupo da faixa de opções.

Valor de retorno

Comentários

CMFCRibbonButtonsGroup::HasImages

Relata se o objeto CMFCRibbonButtonsGroup contém imagens da barra de ferramentas.

BOOL HasImages() const;

Valor de retorno

Retornará TRUE se o membro protegido CMFCToolBarImages m_Images contiver qualquer imagem ou FALSE se não contiver.

Comentários

CMFCRibbonButtonsGroup::OnDrawImage

Desenha a imagem apropriada de um botão especificado, dependendo de o botão estar normal, realçado ou desabilitado.

virtual void OnDrawImage(
    CDC* pDC,
    CRect rectImage,
    CMFCRibbonBaseElement* pButton,
    int nImageIndex);

Parâmetros

pDC
[in] Ponteiro para o contexto do dispositivo do objeto CMFCRibbonButtonsGroup.

rectImage
[in] O retângulo no qual desenhar a imagem.

pButton
[in] O botão para o qual desenhar a imagem.

nImageIndex
[in] O índice da imagem a ser desenhada no botão (em uma das três matrizes de imagem para botões normais, realçados ou desabilitados).

Comentários

CMFCRibbonButtonsGroup::RemoveAll

Remove todos os botões do objeto CMFCRibbonButtonsGroup.

void RemoveAll();

Comentários

CMFCRibbonButtonsGroup::SetImages

Atribui imagens ao grupo de botões da faixa de opções.

void SetImages(
    CMFCToolBarImages* pImages,
    CMFCToolBarImages* pHotImages,
    CMFCToolBarImages* pDisabledImages);

Parâmetros

pImages
[in] Imagens regulares.

pHotImages
[in] Imagens quentes.

pDisabledImages
[in] Imagens desabilitadas.

Comentários

Chame SetImages antes de adicionar botões a um grupo. O número de imagens deve ser maior ou igual ao número de botões a serem adicionados ao grupo.

Observação

Imagens quentes são imagens exibidas quando o usuário passa o mouse sobre o botão. Imagens desabilitadas são imagens exibidas quando o botão está desabilitado.

CMFCRibbonButtonsGroup::SetParentCategory

Define o CMFCRibbonCategory pai do objeto CMFCRibbonButtonsGroup e todos os botões dentro dele.

virtual void SetParentCategory(CMFCRibbonCategory* pCategory);

Parâmetros

pCategory
[in] Ponteiro para a categoria pai a ser definida (os grupos com guias nos controles de faixa de opções são chamados de categorias).

Comentários

Confira também

Gráfico da hierarquia
Classes