CMFCRibbonButtonsGroup Class

A CMFCRibbonButtonsGroup aula permite-te organizar um conjunto de botões de fita num grupo. Todos os botões do grupo estão diretamente adjacentes uns aos outros horizontalmente e envoltos numa borda.

Sintaxe

class CMFCRibbonButtonsGroup : public CMFCRibbonBaseElement

Membros

Construtores Públicos

Métodos Públicos

Observações

O grupo deriva de CMFCBaseRibbonElement e pode ser manipulado como uma única entidade. Podes posicionar o grupo em qualquer painel ou menu pop-up.

Example

O exemplo seguinte demonstra como usar vários métodos na CMFCRibbonButtonsGroup aula. O exemplo mostra como construir um CMFCRibbonButtonsGroup objeto, atribuir imagens ao grupo de botões de fita e adicionar um botão ao grupo de botões de fita. Este excerto de código faz parte do exemplo Draw Client.

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

Requerimentos

Cabeçalho: afxribbonbuttonsgroup.h

CMFCRibbonButtonsGroup::AddButton

Adiciona um botão a um grupo.

void AddButton(CMFCRibbonBaseElement* pButton);

Parâmetros

pButton
[dentro] Um apontador para um botão para adicionar.

CMFCRibbonButtonsGroup::AddButtons

Adiciona uma lista de botões a um grupo.

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

Parâmetros

lstButtons
[dentro] Uma lista de indicadores para os botões que queres adicionar.

CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup

Constrói um CMFCRibbonButtonsGroup objeto.

CMFCRibbonButtonsGroup();
CMFCRibbonButtonsGroup(CMFCRibbonBaseElement* pButton);

Parâmetros

pButton
[dentro] Especifica um botão para adicionar ao objeto recém-criado CMFCRibbonButtonsGroup .

Valor de retorno

Observações

CMFCRibbonButtonsGroup::GetButton

Devolve um ponteiro para o botão localizado num índice especificado.

CMFCRibbonBaseElement* GetButton(int i) const;

Parâmetros

eu
[dentro] Um índice em base zero de um botão para voltar.

Valor de retorno

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

Observações

CMFCRibbonButtonsGroup::GetCount

Devolve 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 elemento m_Imagesprotegido CMFCToolBarImages .

const CSize GetImageSize() const;

Valor de retorno

Devolve o tamanho da imagem de origem das imagens da barra de ferramentas, se houver alguma, ou a CSize de zero se não existirem.

Observações

CMFCRibbonButtonsGroup::GetRegularSize

Recupera o tamanho máximo possível do elemento do grupo fita.

virtual CSize GetRegularSize(CDC* pDC);

Parâmetros

pDC
[dentro] Apontar para o contexto do dispositivo do grupo de fitas.

Valor de retorno

Observações

CMFCRibbonButtonsGroup::HasImages

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

BOOL HasImages() const;

Valor de retorno

Retorna TRUE se o membro m_Images protegido CMFCToolBarImages contiver imagens, ou FALSE se não.

Observações

CMFCRibbonButtonsGroup::OnDrawImage

Desenha a imagem apropriada para um botão especificado, dependendo se o botão está normal, destacado ou desativado.

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

Parâmetros

pDC
[dentro] Apontador para o contexto do dispositivo do CMFCRibbonButtonsGroup objeto.

rectImage
[dentro] O retângulo dentro do qual desenhar a imagem.

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

nImageIndex
[dentro] O índice da imagem a desenhar no botão (num dos três arrays de imagem para botões normais, destacados ou desativados).

Observações

CMFCRibbonButtonsGroup::RemoveAll

Remove todos os botões do CMFCRibbonButtonsGroup objeto.

void RemoveAll();

Observações

CMFCRibbonButtonsGroup::SetImages

Atribui imagens ao grupo de botões de fita.

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

Parâmetros

pImagens
[dentro] Imagens normais.

pHotImages
[dentro] Imagens quentes.

pDisabledImages
[dentro] Imagens desativadas.

Observações

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

CMFCRibbonButtonsGroup::SetParentCategory

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

virtual void SetParentCategory(CMFCRibbonCategory* pCategory);

Parâmetros

pCategoria
[dentro] Apontar para a categoria principal para definir (os grupos separados nos controlos de fita são chamados categorias).

Observações

Consulte também

Gráfico de Hierarquia
Classes