Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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
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