Partilhar via


Classe CMFCRibbonPanel

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Implementa um painel que contém um conjunto de elementos de fita. Quando o painel é desenhado, mostra o maior número possível de elementos, tendo em conta o tamanho do painel.

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

Sintaxe

class CMFCRibbonPanel : public CObject

Membros

Construtores Protegidos

Nome Description
CMFCRibbonPanel::CMFCRibbonPanel Constrói e inicializa um CMFCRibbonPanel objeto.

Métodos Públicos

Nome Description
CMFCRibbonPainel::Adicionar Adiciona um elemento de fita ao painel.
CMFCRibbonPanel::AddSeparator Adiciona um separador ao painel de fita.
CMFCRibbonPanel::AddToolBar Adiciona uma barra de ferramentas ao painel de fitas.
CMFCRibbonPainel::FindByData
CMFCRibbonPainel::FindByID Devolve um elemento identificado por um ID de comando especificado.
CMFCRibbonPainel::GetCaptionHeight
CMFCRibbonPainel::GetCount Devolve o número de elementos no painel de fita.
CMFCRibbonPanel::GetData Devolve os dados definidos pelo utilizador associados ao painel.
CMFCRibbonPanel::GetDefaultButton
CMFCRibbonPainel::GetDroppedDown
CMFCRibbonPanel::GetElement Devolve o elemento da fita localizado num índice especificado.
CMFCRibbonPanel::GetElements Recupera todos os elementos contidos no painel de fita.
CMFCRibbonPanel::GetElementsByID
CMFCRibbonPainel::FiqueFocado Devolve um elemento focado.
CMFCRibbonPainel::GetGalleryRect Devolve um retângulo delimitador do elemento Galeria.
CMFCRibbonPainel::GetHighlight
CMFCRibbonPanel::GetIndex
CMFCRibbonPanel::GetItemIDsList
CMFCRibbonPainel::GetName
CMFCRibbonPainel::GetParentButton
CMFCRibbonPainel::GetParentCategory Devolve a categoria principal do painel de fita.
CMFCRibbonPainel::GetParentMenuBar
CMFCRibbonPainel::GetPreferedMenuLocation
CMFCRibbonPainel::GetPressed
CMFCRibbonPainel::GetRect
CMFCRibbonPanel::GetVisibleElements Obtém uma variedade de elementos visíveis.
CMFCRibbonPanel::HasElement
CMFCRibbonPainel::HitTest
CMFCRibbonPainel::HitTestEx
CMFCRibbonPainel::Inserir Insere um elemento de fita na posição dada.
CMFCRibbonPainel::InsertSeparator Insere um separador na posição indicada.
CMFCRibbonPainel::IsCenterColumnVert Especifica se todos os elementos do painel devem estar centrados (alinhados) verticalmente, por coluna.
CMFCRibbonPainel::EstáCollapsed
CMFCRibbonPainel::EstáDestacado
CMFCRibbonPainel::IsJustifyColumns Especifica se todas as colunas dos painéis têm a mesma largura.
CMFCRibbonPanel::IsMainPanel
CMFCRibbonPanel::IsMenuMode
CMFCRibbonPainel::TornarIitemGaleriaVisível Percorre a galeria para tornar visível o elemento Ribbon especificado.
CMFCRibbonPainel::OnKey
CMFCRibbonPainel::RecalcWidths
CMFCRibbonPainel::Remover Remove e opcionalmente elimina um elemento localizado no índice especificado.
CMFCRibbonPainel::RemoveAll Remove todos os elementos do painel de fita.
CMFCRibbonPainel::Substituir Substitui um elemento por outro com base nos respetivos valores do seu índice.
CMFCRibbonPainel::ReplaceByID Substitui um elemento por outro com base num ID de comando especificado.
CMFCRibbonPainel::SetCenterColumnVert Ordena ao painel que alinhe os elementos verticalmente, por coluna.
CMFCRibbonPanel::SetData Associa os dados definidos pelo utilizador ao painel de fitas.
CMFCRibbonPanel::SetElementMenu Atribui um menu pop-up ao elemento que tem o ID de comando indicado.
CMFCRibbonPanel::SetElementRTC Adiciona um elemento de fita especificado pela informação de classe de execução fornecida ao painel de fita.
CMFCRibbonPanel::SetElementRTCByID Adiciona um elemento de fita especificado pela informação de classe de execução fornecida ao painel de fita.
CMFCRibbonPainel::SetFocused Define o foco no elemento Fita especificado.
CMFCRibbonPanel::SetJustifyColumns Ativa ou desativa a justificação da coluna.
CMFCRibbonPainel::ChavesDeConjunto Define o atalho de teclado que mostra o painel de fitas.
CMFCRibbonPainel::MostrarPopup

Observações

Os painéis de fita são agrupamentos lógicos de tarefas relacionadas que crias dentro das categorias de fita. À medida que o tamanho da fita muda, a disposição dos painéis ajusta-se automaticamente para mostrar o maior número possível de elementos.

Pode obter um painel de fita contido numa categoria de fita ligando para o método CMFCRibbonCategory::GetPanel .

Example

O exemplo seguinte demonstra como configurar um CMFCRibbonPanel objeto usando vários métodos na CMFCRibbonPanel classe. O exemplo mostra como definir o atalho de teclado que mostra o painel de fita, alinhar os elementos do painel verticalmente por coluna e ativar a justificação por coluna. Este excerto de código faz parte do exemplo de demonstração do MS Office 2007.

// CMFCRibbonCategory* pCategory
// CMFCToolBarImages m_PanelImages
CMFCRibbonPanel *pPanelClipboard = pCategory->AddPanel(_T("Clipboard"), m_PanelImages.ExtractIcon(1));
pPanelClipboard->SetKeys(_T("zc"));
pPanelClipboard->SetCenterColumnVert();
pPanelClipboard->SetJustifyColumns();

Hierarquia de herança

CObject

CMFCRibbonPanel

Requerimentos

Cabeçalho: afxRibbonPanel.h

CMFCRibbonPainel::Adicionar

Adiciona o elemento de fita especificado ao array de elementos de fita contido no painel de fita.

virtual void Add(CMFCRibbonBaseElement* pElem);

Parâmetros

pElem
[inspira, expira] Aponta para um elemento fita.

Observações

CMFCRibbonPanel::AddSeparator

Adiciona um separador ao painel de fita.

virtual void AddSeparator();

Observações

Chame este método para adicionar um separador ao painel de fita. O separador será adicionado ao lado do elemento de fita que foi adicionado pela chamada anterior ao CMFCRibbonPanel::Add. Para inserir um separador numa determinada posição, chame CMFCRibbonPanel::InsertSeparator.

CMFCRibbonPanel::AddToolBar

Adiciona uma barra de ferramentas ao painel de fitas.

CMFCRibbonButtonsGroup* AddToolBar(
UINT uiToolbarResID,
UINT uiColdResID = 0,
UINT uiHotResID = 0,
UINT uiDisabledResID = 0);

Parâmetros

uiToolbarResID
[dentro] Especifica o ID do recurso da barra de ferramentas a adicionar.

uiColdResID
[dentro] Especifica o ID de recurso das imagens frias da barra de ferramentas.

uiHotResID
[dentro] Especifica o ID de recurso das imagens quentes da barra de ferramentas.

uiDisabledResID
[dentro] Especifica o ID de recurso das imagens desativadas da barra de ferramentas.

Valor de retorno

Chame este método para adicionar uma barra de ferramentas ao painel de fitas. A barra de ferramentas será adicionada ao lado do elemento de fita adicionado pela chamada anterior ao CMFCRibbonPanel::Add.

Observações

Para mais informações sobre barras de ferramentas, imagens ativas, imagens frias e imagens desativadas, consulte CMFCToolBar Class.

CMFCRibbonPanel::CMFCRibbonPanel

Constrói e inicializa um objeto CMFCRibbonPanel .

CMFCRibbonPanel(
LPCTSTR lpszName = NULL,
HICON hIcon = NULL);

CMFCRibbonPanel(CMFCRibbonGallery* pPaletteButton);

Parâmetros

lpszName
[dentro] O nome do painel de fita.

hIcon
[dentro] Handle para o ícone do botão padrão do painel de fita.

pPaletteButton
[dentro] Aponta para uma galeria de fitas para o painel de fitas.

CMFCRibbonPainel::FindByData

Recupera o elemento de fita associado aos dados especificados.

CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData) const;

Parâmetros

dwData
[dentro] Os dados associados a um elemento fita.

Valor de retorno

Apontar para um elemento de fita se o método fosse bem-sucedido; caso contrário, NULL.

Observações

CMFCRibbonPainel::FindByID

Recupera o elemento de fita identificado pelo ID de comando especificado.

CMFCRibbonBaseElement* FindByID(UINT uiCmdID) const;

Parâmetros

uiCmdID
[dentro] O ID de comando de um elemento fita.

Valor de retorno

O elemento fita identificado pelo ID de comando especificado; caso contrário, NULL se nenhum elemento da fita for identificado com o ID de comando especificado.

CMFCRibbonPainel::GetCaptionHeight

Recupera a altura de uma legenda para o painel de fita.

int GetCaptionHeight() const;

Valor de retorno

A altura, em pixels, de uma legenda para o painel de fita.

Observações

CMFCRibbonPainel::GetCount

Recupera o número de elementos de fita contidos no painel de fita.

int GetCount() const;

Valor de retorno

O número de elementos de fita contidos no painel de fita.

CMFCRibbonPanel::GetData

Devolve os dados definidos pelo utilizador associados ao painel.

DWORD_PTR GetData() const;

Valor de retorno

Os dados definidos pelo utilizador associados ao painel.

CMFCRibbonPanel::GetDefaultButton

Recupera o botão padrão do painel de fitas.

CMFCRibbonButton& GetDefaultButton();

Valor de retorno

O botão padrão para o painel de fita.

Observações

O botão padrão é exibido quando um painel de fita não tem espaço suficiente para exibir os seus elementos de fita.

CMFCRibbonPainel::GetDroppedDown

Recupera um ponteiro para um elemento de fita se o menu pop-up for descido.

CMFCRibbonBaseElement* GetDroppedDown() const;

Valor de retorno

Apontar para o elemento de fita que tem o menu pop-up descido; caso contrário, NULL se nenhum elemento de fita tiver o menu pop-up descido.

Observações

Apenas os elementos de fita contidos no painel de fita são testados.

CMFCRibbonPanel::GetElement

Devolve o elemento da fita localizado num índice especificado.

CMFCRibbonBaseElement* GetElement(int nIndex) const;

Parâmetros

nIndex
[dentro] Especifica o índice baseado em zero do elemento a recuperar.

Valor de retorno

Um ponteiro válido para o elemento base da fita localizado na posição nIndex no painel da fita, ou NULL se não houver elemento no índice especificado.

CMFCRibbonPanel::GetElements

Recupera todos os elementos da fita que estão contidos no painel da fita.

void GetElements(CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parâmetros

arElements
[fora] Um array para preencher com todos os elementos de fita contidos no painel de fita.

Observações

CMFCRibbonPanel::GetElementsByID

Adiciona elementos de fita que têm o ID de comando especificado ao array especificado.

void GetElementsByID(
UINT uiCmdID,
CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parâmetros

uiCmdID
[dentro] ID de comando para um elemento fita.

arElements
[dentro] Conjunto de elementos de fita.

Observações

Apenas os elementos de fita contidos no painel de fita são testados.

CMFCRibbonPainel::GetHighlight

Recupera o elemento de fita que está destacado no painel de fita.

CMFCRibbonBaseElement* GetHighlighted() const;

Valor de retorno

Aponta para o elemento de fita que está destacado no painel de fita.

Observações

CMFCRibbonPanel::GetIndex

Recupera o índice em base zero do elemento de fita especificado a partir do array de elementos de fita contidos no painel de fita.

virtual int GetIndex(CMFCRibbonBaseElement* pElem) const;

Parâmetros

pElem
[dentro] Aponta para um elemento fita.

Valor de retorno

Índice baseado em zero do elemento de fita especificado se o método fosse bem-sucedido; caso contrário -1.

Observações

CMFCRibbonPanel::GetItemIDsList

Recupera os IDs de comandos para todos os elementos da fita no painel da fita.

void GetItemIDsList(CList<UINT, UINT>& lstItems) const;

Parâmetros

lstItens
[fora] A lista de IDs de comandos para elementos de fita que estão contidos no painel de fita.

Observações

CMFCRibbonPainel::GetName

Recupera o nome do painel de fita.

LPCTSTR GetName() const;

Valor de retorno

O nome do painel de fita.

Observações

CMFCRibbonPainel::GetParentButton

CMFCRibbonBaseElement* GetParentButton() const;

Valor de retorno

Observações

CMFCRibbonPainel::GetParentCategory

Devolve a categoria principal do painel de fita.

CMFCRibbonCategory* GetParentCategory() const;

Valor de retorno

Um apontador para a categoria de fita que contém este painel de fita.

CMFCRibbonPainel::GetParentMenuBar

CMFCRibbonPanelMenuBar* GetParentMenuBar() const;

Valor de retorno

Observações

CMFCRibbonPainel::GetPreferedMenuLocation

Recupera o retângulo de ecrã preferido para o menu pop-up do painel de fita.

virtual BOOL GetPreferedMenuLocation(CRect& rect);

Parâmetros

retângulo
[fora] Este parâmetro não é utilizado.

Valor de retorno

Sempre devolve FALSE.

Observações

Este método devolve sempre FALSE. Substitua este método para recuperar o retângulo de ecrã preferido para o menu pop-up do painel de fitas.

CMFCRibbonPainel::GetPressed

Recupera um ponteiro para um elemento de fita no painel de fita se o utilizador o pressionar atualmente.

CMFCRibbonBaseElement* GetPressed() const;

Valor de retorno

Um apontador para um elemento de fita se o utilizador o pressionar no momento; caso contrário, NULL.

Observações

CMFCRibbonPainel::GetRect

Recupera o retângulo do ecrã para o painel de fita.

const CRect& GetRect() const;

Valor de retorno

O retângulo do ecrã para o painel de fita.

Observações

CMFCRibbonPanel::HasElement

Indica se o painel de fita contém o elemento de fita especificado.

BOOL HasElement(const CMFCRibbonBaseElement* pElem) const;

Parâmetros

pElem
[dentro] Aponta para um elemento fita.

Valor de retorno

TRUE se o painel de fita contiver o elemento de fita especificado; caso contrário, FALSO.

Observações

CMFCRibbonPainel::Destaques

Define a cor de destaque para o painel de fita selecionado e para o elemento de fita especificado pelo ponto.

virtual void Highlight(
BOOL bHighlight,
CPoint point);

Parâmetros

bDestaques
[dentro] VERDADEIRO para destacar o painel de fita; FALSE para desvalorizar o painel de fita.

ponto
[dentro] As coordenadas x e y do ponteiro, relativas ao canto superior esquerdo da janela.

Observações

CMFCRibbonPainel::HitTest

Recupera um elemento de fita se o ponto especificado estiver localizado nele.

virtual CMFCRibbonBaseElement* HitTest(
CPoint point,
BOOL bCheckPanelCaption = FALSE);

Parâmetros

ponto
[dentro] As coordenadas x e y do ponteiro, relativas ao canto superior esquerdo da janela.

bCheckPanelCaption
[dentro] TRUE para testar a legenda do painel de fita; caso contrário, FALSO.

Valor de retorno

Apontar para um elemento de fita se o ponto especificado estiver localizado nele; caso contrário, NULL.

Observações

Apenas os elementos de fita contidos no painel de fita são testados.

CMFCRibbonPainel::HitTestEx

Recupera o índice baseado em zero do elemento fita que tem o ponto especificado localizado nele.

virtual int HitTestEx(CPoint point) const;

Parâmetros

ponto
[dentro] As coordenadas x e y do ponteiro, relativas ao canto superior esquerdo da janela.

Valor de retorno

O índice baseado em zero do elemento fita que tem o ponto especificado localizado nele; caso contrário -1.

Observações

Apenas os elementos de fita contidos no painel de fita são testados.

CMFCRibbonPainel::Inserir

Insere o elemento de fita especificado na posição especificada no array de elementos de fita contido no painel de fita.

virtual BOOL Insert(
CMFCRibbonBaseElement* pElem,
int nIndex);

Parâmetros

pElem
[inspira, expira] Aponta para um elemento fita.

nIndex
[dentro] Valor baseado em zero, variando de -1 até ao número de elementos de fita contidos no array.

Valor de retorno

TRUE se o elemento da fita foi inserido com sucesso; caso contrário, FALSO.

Observações

Se o valor de nIndex for -1, ou se nIndex for igual ao número de elementos de fita no array, o elemento de fita especificado é adicionado ao final do array. Se o valor de nIndex estiver fora do intervalo, o método falhará.

CMFCRibbonPainel::InsertSeparator

Insere um separador na posição indicada.

virtual BOOL InsertSeparator(int nIndex);

Parâmetros

nIndex
[dentro] Especifica o índice baseado em zero onde o separador é inserido.

Valor de retorno

TRUE se o separador tiver sido inserido com sucesso; caso contrário, FALSO.

Observações

Chame este método para inserir um separador na posição especificada por nIndex. Para inserir um separador ao lado do elemento de fita adicionado mais recentemente, chame CMFCRibbonPanel::AddSeparator.

CMFCRibbonPainel::IsCenterColumnVert

Indica se as posições verticais dos elementos da fita estão centradas dentro do seu retângulo de visualização.

BOOL IsCenterColumnVert() const;

Valor de retorno

TRUE se as posições verticais dos elementos da fita estiverem centradas dentro do seu retângulo de visualização; caso contrário, FALSO.

CMFCRibbonPainel::EstáCollapsed

Indica se o tamanho do ecrã do painel de fita está minimizado na direção horizontal.

BOOL IsCollapsed() const;

Valor de retorno

TRUE se o tamanho do ecrã do painel de fita for minimizado na direção horizontal; caso contrário, FALSO.

Observações

Quando um painel de fita é dobrado, apenas mostra o seu botão predefinido, o seu nome e uma seta suspensa.

CMFCRibbonPainel::EstáDestacado

Indica se o ecrã do painel de fita está destacado.

BOOL IsHighlighted() const;

Valor de retorno

TRUE se o ecrã do painel de fita estiver destacado; caso contrário, FALSO.

Observações

O ecrã de um painel de fita é destacado quando o ponteiro está por cima.

CMFCRibbonPainel::IsJustifyColumns

Indica se as dimensões de exibição dos elementos da fita que estão na mesma coluna no painel da fita estão definidas com a mesma largura.

BOOL IsJustifyColumns() const;

Valor de retorno

TRUE se as dimensões de exibição dos elementos de fita que estão na mesma coluna no painel de fita forem definidas com a mesma largura; caso contrário, FALSO.

CMFCRibbonPanel::IsMainPanel

Indica se o painel de fita é o painel de fita principal.

virtual BOOL IsMainPanel() const;

Valor de retorno

Sempre devolve FALSE.

Observações

Este método devolve sempre FALSE. Anule este método para indicar se o painel de fita é o painel de fita principal.

O painel principal de fita é exibido quando o utilizador seleciona o botão de aplicação.

CMFCRibbonPanel::IsMenuMode

BOOL IsMenuMode() const;

Valor de retorno

Observações

CMFCRibbonPainel::OnKey

virtual BOOL OnKey(UINT nChar);

Parâmetros

[dentro] nChar

Valor de retorno

Observações

CMFCRibbonPainel::RecalcWidths

Recalcula a largura de cada configuração de layout de ecrã para o painel de fita.

virtual void RecalcWidths(
CDC* pDC,
int nHeight);

Parâmetros

pDC
[dentro] Apontar para o contexto de um dispositivo para o painel de fita.

nAltura
[dentro] A altura do painel de fita.

Observações

Um painel de fita altera a sua configuração de disposição à medida que a largura disponível muda.

CMFCRibbonPainel::Remover

Remove e opcionalmente elimina um elemento localizado no índice especificado.

BOOL Remove(
int nIndex,
BOOL bDelete = TRUE);

Parâmetros

nIndex
[dentro] Especifica o índice baseado em zero do elemento que é removido do painel de fita.

bDelete
[dentro] TRUE para eliminar o elemento a ser removido; caso contrário, FALSO.

Valor de retorno

TRUE se o elemento tiver sido removido e eliminado (se bDelete for TRUE); FALSE se o elemento não foi removido ou se não houver elemento de fita localizado em nIndex.

Observações

Chame este método para remover um elemento do painel de fitas.

CMFCRibbonPainel::RemoveAll

Elimina todos os elementos da fita do painel da fita.

void RemoveAll();

Observações

Todos os elementos da fita são removidos do painel da fita e destruídos.

CMFCRibbonPainel::Substituir

Substitui um elemento por outro com base no seu valor de índice.

BOOL Replace(
int nIndex,
CMFCRibbonBaseElement* pElem);

Parâmetros

nIndex
[dentro] Especifica o índice baseado em zero do elemento a substituir.

pElem
[inspira, expira] Um ponteiro válido para o elemento que substitui o elemento original.

Valor de retorno

TRUE se o elemento de fita original tiver sido substituído com sucesso pelo novo elemento de fita; FALSE se o elemento da fita não foi substituído ou se não houver elemento no índice especificado.

Observações

Para substituir um elemento de fita pelo ID de comando, chame CMFCRibbonPanel::ReplaceByID.

CMFCRibbonPainel::ReplaceByID

Substitui um elemento por outro com base num ID de comando especificado.

BOOL ReplaceByID(
UINT uiCmdID,
CMFCRibbonBaseElement* pElem);

Parâmetros

uiCmdID
[dentro] Especifica o ID de comando do elemento a substituir.

pElem
[inspira, expira] Um ponteiro válido para o elemento que substituirá o elemento original.

Valor de retorno

TRUE se o elemento de fita original tiver sido substituído com sucesso pelo novo elemento de fita; FALSE se o elemento da fita não foi substituído ou se nenhum elemento com o ID de comando especificado existir realmente.

Observações

Para substituir um elemento de fita com base na posição, chame CMFCRibbonPanel::Replace.

CMFCRibbonPainel::SetCenterColumnVert

Permite ou desativa a centralização das posições verticais dos elementos da fita dentro do seu retângulo de visualização.

void SetCenterColumnVert(BOOL bSet = TRUE);

Parâmetros

bSet
[dentro] TRUE para centrar as posições verticais dos elementos da fita dentro do seu retângulo de visualização; FALSE para desativar esta funcionalidade.

Observações

CMFCRibbonPanel::SetData

Associa os dados definidos pelo utilizador ao painel de fitas.

void SetData(DWORD_PTR dwData);

Parâmetros

dwData
[dentro] Especifica os dados definidos pelo utilizador a definir.

Observações

Chame este método para associar dados definidos pelo utilizador ao painel de fitas.

CMFCRibbonPanel::SetElementMenu

Atribui um menu pop-up ao elemento que tem o ID de comando indicado.

BOOL SetElementMenu(
UINT uiCmdID,
HMENU hMenu,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);

BOOL SetElementMenu(
UINT uiCmdID,
UINT uiMenuResID,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);

Parâmetros

uiCmdID
[dentro] Especifica o ID de comando do elemento de fita onde o menu é adicionado.

hMenu
[dentro] Especifica a alavanca do menu Windows para adicionar ao painel de fita.

bIsDefautCommand
[dentro] TRUE para especificar que o comando associado ao elemento fita deve ser executado se o elemento fita for clicado. Neste caso, o menu só é aberto quando o utilizador clica na seta ao lado do elemento da fita. FALSE para especificar que o comando associado ao elemento da fita não deve ser executado se o elemento da fita for clicado. Neste caso, o menu pop-up aparece independentemente de onde o utilizador clica no elemento.

bRightAlign
[dentro] TRUE para especificar que o menu pop-up está alinhado à direita; caso contrário, FALSO.

uiMenuResID
[dentro] Especifica o ID do recurso do menu a adicionar ao painel de fitas.

Valor de retorno

TRUE se o menu tiver sido atribuído ao elemento fita; caso contrário, FALSO.

Observações

Chame este método para atribuir um menu popup ao elemento de fita que tem o ID de comando indicado.

CMFCRibbonPanel::SetElementRTC

Adiciona o elemento de fita especificado pela informação de classe de runtime fornecida ao painel de fita.

CMFCRibbonBaseElement* SetElementRTC(
int nIndex,
CRuntimeClass* pRTC);

Parâmetros

nIndex
[dentro] Especifica o índice baseado em zero do elemento fita a adicionar.

pRTC
[inspira, expira] Um apontador para a informação da classe em tempo de execução para o elemento de fita que é adicionado ao painel de fita.

Valor de retorno

O elemento de fita que foi criado usando a informação especificada da classe de execução.

Observações

Se quiser adicionar um elemento personalizado (por exemplo, um botão de cor) ao painel de fita, deve especificar a informação da classe de execução do elemento personalizado. A fita armazena esta informação, cria o elemento personalizado e substitui um elemento existente que está localizado (identificado) pelo ID de comando especificado. A fita devolve então um ponteiro para o elemento recém-criado.

CMFCRibbonPanel::SetElementRTCByID

Adiciona um elemento de fita que é especificado pela informação de classe de runtime fornecida ao painel de fita.

CMFCRibbonBaseElement* SetElementRTCByID(
UINT uiCmdID,
CRuntimeClass* pRTC);

Parâmetros

uiCmdID
[dentro] Especifica o ID do comando do elemento de fita a adicionar.

pRTC
[inspira, expira] Um apontador para a informação da classe em tempo de execução associada ao elemento de fita que é adicionado ao painel de fita.

Valor de retorno

O elemento de fita que foi criado usando a informação especificada da classe de execução.

Observações

Se quiser adicionar um elemento personalizado (por exemplo, um botão de cor) ao painel de fita, deve especificar a informação da classe de execução do elemento personalizado. A fita armazena esta informação, cria o elemento personalizado e substitui um elemento existente localizado pelo ID de comando especificado. Depois, devolve um ponteiro para o elemento recém-criado.

Example

O exemplo seguinte mostra como usar o SetElementRTCByID método:

// Load and add toolbar with standard buttons. This toolbar
// should display a custom color button with id ID_CHAR_COLOR:

pPanel->AddToolBar(IDR_MAINFRAME,
    IDB_MAINFRAME256);

CMFCRibbonColorButton* pColorButton =
(CMFCRibbonColorButton*)pPanel->SetElementRTCByID(
ID_CHAR_COLOR,
    RUNTIME_CLASS (CMFCRibbonColorButton));

// SetElementRTCByID sets runtime class and returns a pointer
// to the newly created custom button,
    which can be set up immediately:
pColorButton->EnableAutomaticButton(_T("Automatic"),
    RGB (0,
    0,
    0));

CMFCRibbonPanel::SetJustifyColumns

Permite ou desativa o ajuste da largura dos elementos da fita na mesma coluna.

void SetJustifyColumns(BOOL bSet = TRUE);

Parâmetros

bSet
[dentro] TRUE para ajustar a largura dos elementos de fita na mesma coluna para a largura do maior elemento de fita da coluna; FALSE para desativar este ajuste de largura.

Observações

Quando esta funcionalidade está ativada num painel de fita, as larguras dos elementos de fita na mesma coluna são ajustadas para a largura do maior elemento de fita na mesma coluna.

CMFCRibbonPainel::ChavesDeConjunto

Define a dica do teclado para o botão padrão do painel de fitas.

void SetKeys(LPCTSTR lpszKeys);

Parâmetros

lpszKeys
[dentro] A dica da tecla para o botão padrão do painel de fita.

Observações

O botão padrão é exibido quando um painel de fita não tem espaço suficiente para exibir os seus elementos de fita.

CMFCRibbonPainel::MostrarPopup

Cria e mostra um menu pop-up para o painel de fitas.

CMFCRibbonPanelMenu* ShowPopup(CMFCRibbonDefaultPanelButton* pButton = NULL);

Parâmetros

pButton
[dentro] Aponta para o botão predefinido do painel de fitas.

Valor de retorno

Apontar para o menu pop-up do painel de fita se o método fosse bem-sucedido; caso contrário, NULL.

Observações

O menu pop-up para o painel de fita só está disponível quando o ecrã do painel de fita está dobrado.

CMFCRibbonPainel::SetFocused

Define o foco no elemento Fita especificado.

void SetFocused(CMFCRibbonBaseElement* pNewFocus);

Parâmetros

pNewFocus
Um apontador para um elemento Fita que recebe foco.

Observações

CMFCRibbonPainel::TornarIitemGaleriaVisível

Percorre a galeria para tornar visível o elemento Ribbon especificado.

void MakeGalleryItemVisible(CMFCRibbonBaseElement* pItem);

Parâmetros

pItem
Um indicador para um elemento Fita para mostrar.

Observações

CMFCRibbonPanel::IsWindows7Look

Indica se a fita principal tem o aspeto do Windows 7 (pequeno botão retangular de aplicação).

BOOL IsWindows7Look() const;

Valor de retorno

TRUE se a fita principal tiver aspeto Windows 7; caso contrário, FALSO.

Observações

CMFCRibbonPanel::GetVisibleElements

Recupera um conjunto de elementos visíveis.

void GetVisibleElements(
CArray<CMFCRibbonBaseElement*,
CMFCRibbonBaseElement*>& arElements);

Parâmetros

arElements
Quando a função retorna, este parâmetro contém um array de elementos visíveis.

Observações

CMFCRibbonPainel::GetGalleryRect

Devolve um retângulo delimitador de um elemento da Galeria.

CRect GetGalleryRect();

Valor de retorno

Tamanho e posição do elemento da Galeria dentro deste painel.

Observações

CMFCRibbonPainel::FiqueFocado

Devolve um elemento focado.

CMFCRibbonBaseElement* GetFocused() const;

Valor de retorno

Um apontador para um elemento focado ou NULL.

Observações

Consulte também

Gráfico de Hierarquia
Classes
CObject Classe
Classe CMFCRibbonCategory
Classe CMFCRibbonBaseElement