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
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).