Classe CMFCRibbonBaseElement

a classe de CMFCRibbonBaseElement é a classe base para todos os elementos que você pode adicionar a barra de fita. Exemplos de elementos de fita são botões de fita, caixas de seleção de fita, e caixas de combinação de fita.

class CMFCRibbonBaseElement : public CObject

Membros

Construtores public

Nome	Descrição
CMFCRibbonBaseElement	Constrói um objeto de CMFCRibbonBaseElement .

Métodos públicos

Nome	Descrição
CMFCRibbonBaseElement::AddToKeyList	Adiciona um keytip para o elemento de fita em uma matriz de keytips.
CMFCRibbonBaseElement::AddToListBox	Adiciona um elemento de fita a caixa de listagem especificada dos comandos de fita.
CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar	Indica se o elemento de fita pode ser adicionado à barra de ferramentas de acesso rápido.
CMFCRibbonBaseElement::CanBeCompacted	Indica se o tamanho do elemento de fita pode ser compacto.
CMFCRibbonBaseElement::CanBeStretched	Indica se a altura do elemento de fita pode aumentar verticalmente a altura de uma linha de fita.
CMFCRibbonBaseElement::CanBeStretchedHorizontally	Indica se a largura do elemento de fita pode alterar.
CMFCRibbonBaseElement::CleanUpSizes	Limpa as configurações de dimensão para o elemento de fita.
CMFCRibbonBaseElement::ClosePopupMenu	Fecha o menu pop-up para o elemento de fita.
CMFCRibbonBaseElement::CopyFrom	Copia o estado de CMFCRibbonBaseElement especificado para o objeto atual.
CMFCRibbonBaseElement::DestroyCtrl	Destrói o elemento de fita.
CMFCRibbonBaseElement::DrawImage	Desenha uma imagem para o elemento de fita.
CMFCRibbonBaseElement::Find	Retorna o ponteiro especificado para o elemento de fita se aponta para o objeto atual.
CMFCRibbonBaseElement::FindByData	Recupera um ponteiro para o elemento de fita se contém os dados especificados.
CMFCRibbonBaseElement::FindByID	Recupera um ponteiro para o elemento de fita se o elemento é identificado por certo ID de comando
CMFCRibbonBaseElement::FindByOriginal	Recupera um ponteiro para o elemento de fita se o elemento original de fita corresponde ao elemento especificado de fita.
CMFCRibbonBaseElement::GetCompactSize	Retorna o tamanho compacta de elemento fita.
CMFCRibbonBaseElement::GetData	Recupera os dados definidos pelo usuário associado ao elemento de fita.
CMFCRibbonBaseElement::GetDescription	Retorna a descrição do elemento de fita.
CMFCRibbonBaseElement::GetDroppedDown	Recupera um ponteiro para o elemento de fita se o seu menu pop-up é solto para baixo.
CMFCRibbonBaseElement::GetElements	Adicione o elemento atual de fita a matriz especificada.
CMFCRibbonBaseElement::GetElementsByID	Adicione o elemento atual de fita a matriz especificada se o elemento atual de fita contém a identificação especificada de comando
CMFCRibbonBaseElement::GetHighlighted	Recupera um ponteiro para o elemento de fita se é realçado.
CMFCRibbonBaseElement::GetID	Retorna a identificação de comando do elemento de fita.
CMFCRibbonBaseElement::GetImageSize	Retorna o tamanho da imagem do elemento de fita.
CMFCRibbonBaseElement::GetIntermediateSize	Retorna o tamanho do elemento de fita em seu estado intermediária.
CMFCRibbonBaseElement::GetKeys	Retorna o keytip associado com o elemento de fita.
CMFCRibbonBaseElement::GetKeyTipRect	Recupera o retângulo do limite de keytip para o elemento de fita.
CMFCRibbonBaseElement::GetKeyTipSize	Retorna o tamanho do texto de keytip.
CMFCRibbonBaseElement::GetLocationInGroup	Indica o local de exibição do elemento de fita em um grupo de fita.
CMFCRibbonBaseElement::GetMenuKeys	Retorna os keytips associados com um botão.
CMFCRibbonBaseElement::GetNotifyID	Recupera a identificação do comando de notificação para o elemento de fita.
CMFCRibbonBaseElement::GetOriginal	Recupera o elemento original de fita.
CMFCRibbonBaseElement::GetParentCategory	Recupera a categoria de fita para o elemento de fita.
CMFCRibbonBaseElement::GetParentPanel	Recupera o painel de fita que contém o elemento de fita.
CMFCRibbonBaseElement::GetParentRibbonBar	Recupera a barra pai de fita para o elemento de fita.
CMFCRibbonBaseElement::GetParentWnd	Recupera a janela pai para o elemento de fita.
CMFCRibbonBaseElement::GetPressed	Recupera um ponteiro para o elemento de fita se o usuário pressiona atualmente.
CMFCRibbonBaseElement::GetQuickAccessToolBarID	Recupera a identificação de comando do elemento de fita quando está localizado na barra de ferramentas de acesso rápido.
CMFCRibbonBaseElement::GetRect	Retorna o retângulo delimitador do elemento de fita.
CMFCRibbonBaseElement::GetRegularSize	Retorna o tamanho normal do elemento de fita.
CMFCRibbonBaseElement::GetSize	Retorna o tamanho do elemento atual de fita.
CMFCRibbonBaseElement::GetText	Retorna o texto associado com o elemento de fita.
CMFCRibbonBaseElement::GetToolTipText	Retorna o texto de dica de elemento fita.
CMFCRibbonBaseElement::GetTopLevelRibbonBar	Recupera a barra de fita de nível superior para o elemento de fita.
CMFCRibbonBaseElement::HasCompactMode	Especifica se o elemento de fita tem um modo compacto.
CMFCRibbonBaseElement::HasFocus	Indica se o elemento pai tiver o foco do teclado.
CMFCRibbonBaseElement::HasIntermediateMode	Especifica se o elemento de fita tem um modo intermediária.
CMFCRibbonBaseElement::HasLargeMode	Especifica se o elemento de fita tiver um grande para.
CMFCRibbonBaseElement::HasMenu	Indica se o elemento de fita tem um menu.
CMFCRibbonBaseElement::HitTest	Recupera um ponteiro para o elemento de fita se o ponto especificado está localizado em ele.
CMFCRibbonBaseElement::IsAlignByColumn	Indica se o elemento é alinhado verticalmente de fita com outros elementos de fita.
CMFCRibbonBaseElement::IsAlwaysLargeImage	Indica se o tamanho da imagem do elemento de fita é sempre grande.
CMFCRibbonBaseElement::IsAutoRepeatMode	Indica se o elemento de fita está no modo automático de repetição.
CMFCRibbonBaseElement::IsChecked	Especifica se o elemento de fita é verificado.
CMFCRibbonBaseElement::IsCompactMode	Especifica se o elemento de fita estiver de um modo compacto.
CMFCRibbonBaseElement::IsDefaultMenuLook
CMFCRibbonBaseElement::IsDisabled	Especifica se o elemento de fita está desativado.
CMFCRibbonBaseElement::IsDroppedDown	Determina se o elemento de fita exibe um menu pop-up e solto está pressionada.
CMFCRibbonBaseElement::IsFocused	Especifica se o elemento de fita tem o foco.
CMFCRibbonBaseElement::IsGalleryIcon	Indica se o elemento de fita está contido em uma galeria de fita.
CMFCRibbonBaseElement::IsHighlighted	Especifica se o elemento de fita é realçado.
CMFCRibbonBaseElement::IsIntermediateMode	Indica se a imagem atual para o elemento de fita é tamanho intermediária.
CMFCRibbonBaseElement::IsLargeMode	Indica se a imagem atual para o elemento de fita é grande - dimensionado.
CMFCRibbonBaseElement::IsMenuMode	Indica se o elemento de fita está contido em um menu.
CMFCRibbonBaseElement::IsPressed	Indica se o usuário clicou no elemento de fita.
CMFCRibbonBaseElement::IsQATMode	Indica se o elemento de fita está contido na barra de ferramentas de acesso rápido.
CMFCRibbonBaseElement::IsSeparator	Indica se o elemento de fita é um separador de exibição.
CMFCRibbonBaseElement::IsShowGroupBorder	Indica se o elemento de fita está contido em um grupo que exibe uma borda comuns.
CMFCRibbonBaseElement::IsShowTooltipOnBottom	Indica se a dica de ferramenta é exibido no elemento de fita.
CMFCRibbonBaseElement::IsTabStop	Indica se o elemento de fita pode ser selecionado com o teclado.
CMFCRibbonBaseElement::IsTextAlwaysOnRight	Indica se o texto para o elemento de fita é exibido à direita.
CMFCRibbonBaseElement::IsVisible	Indica se o elemento de fita é exibido no momento.
CMFCRibbonBaseElement::IsWholeRowHeight	Indica se o heigth de exibição do elemento de fita é o mesmo que a altura de exibição do painel fita que o contém.
CMFCRibbonBaseElement::NotifyCommand	Envia uma notificação de comando na janela pai do elemento de fita.
CMFCRibbonBaseElement::NotifyHighlightListItem	Notifica a janela pai de barra fita quando um usuário realça um elemento de fita que está localizado em uma lista.
CMFCRibbonBaseElement::OnAddToQAToolbar	Adicione o elemento de fita a barra de ferramentas especificada de acesso rápido.
CMFCRibbonBaseElement::OnAfterChangeRect	Atualiza a dica de ferramenta para o elemento de fita.
CMFCRibbonBaseElement::OnAutoRepeat	Atualiza o elemento de fita em resposta a entrada do usuário sustentada.
CMFCRibbonBaseElement::OnCalcTextSize	Calcula o tamanho do texto para o elemento de fita.
CMFCRibbonBaseElement::OnChangeMenuHighlight	Chamado pela estrutura quando o realce alterar para um elemento de fita que está localizado em um menu.
CMFCRibbonBaseElement::OnDraw	Chamado pela estrutura para desenhar o elemento de fita.
CMFCRibbonBaseElement::OnDrawKeyTip	Chamado pela estrutura para desenhar o keytip para o elemento de fita.
CMFCRibbonBaseElement::OnDrawMenuImage	Chamado pela estrutura quando a imagem de menu para o elemento de fita é desenhada.
CMFCRibbonBaseElement::OnDrawOnList	Chamado pela estrutura para desenhar o elemento de fita em uma caixa de listagem de comandos.
CMFCRibbonBaseElement::OnKey	Chamado pela estrutura quando o usuário pressiona um keytip e o elemento de fita tem o foco.
CMFCRibbonBaseElement::OnMenuKey
CMFCRibbonBaseElement::OnRTLChanged	Chamado pela estrutura quando o layout modificar a direção.
CMFCRibbonBaseElement::OnShow	Chamado pela estrutura para mostrar ou ocultar o elemento de fita.
CMFCRibbonBaseElement::OnShowPopupMenu	Chamado pela estrutura quando o elemento de fita é exibir um menu pop-up.
CMFCRibbonBaseElement::PostMenuCommand
CMFCRibbonBaseElement::Redraw	Atualize a exibição para o elemento de fita.
CMFCRibbonBaseElement::SetACCData	Defina os dados de acessibilidade para o elemento de fita.
CMFCRibbonBaseElement::SetCompactMode	Defina o tamanho de exibição para o elemento de fita.
CMFCRibbonBaseElement::SetData	Associa um item de dados com o elemento de fita.
CMFCRibbonBaseElement::SetDefaultMenuLook
CMFCRibbonBaseElement::SetDescription	Define a descrição para o elemento de fita.
CMFCRibbonBaseElement::SetID	Define a identificação de comando do elemento de fita.
CMFCRibbonBaseElement::SetInitialMode	Defina o tamanho inicial de exibição para o elemento de fita.
CMFCRibbonBaseElement::SetKeys	Define um keytip para o elemento de fita.
CMFCRibbonBaseElement::SetOriginal	Define o elemento original de fita para o elemento de fita.
CMFCRibbonBaseElement::SetParentCategory	Define a categoria pai para o elemento de fita.
CMFCRibbonBaseElement::SetParentMenu	Define o recipiente pai de menu para o elemento de fita.
CMFCRibbonBaseElement::SetParentRibbonBar	Define a barra pai de fita para o elemento de fita.
CMFCRibbonBaseElement::SetRect	Defina as dimensões fot que exibe o retângulo para o elemento de fita.
CMFCRibbonBaseElement::SetText	Define o texto para o elemento de fita.
CMFCRibbonBaseElement::SetTextAlwaysOnRight	Define o texto para que o elemento de fita exibe à direita.
CMFCRibbonBaseElement::SetToolTipText	Define o texto de dica de ferramenta para o elemento de fita.
CMFCRibbonBaseElement::SetVisible	Define o estado de visibilidade do elemento de fita.
CMFCRibbonBaseElement::StretchHorizontally	Redimensiona a largura do elemento de fita.
CMFCRibbonBaseElement::StretchToWholeRow	Altera a altura de exibição do elemento de fita a altura da linha especificada.
CMFCRibbonBaseElement::UpdateTooltipInfo	Atualiza o texto de tooltip usando o recurso de comando para o elemento de fita.

Métodos protegidos

Nome	Descrição
CMFCRibbonBaseElement::OnProcessKey	Chamado pela estrutura quando o usuário pressionar uma tecla de atalho.
CMFCRibbonBaseElement::OnSetFocus	Chamado pela estrutura quando um elemento de fita receber ou perde o foco de entrada.

Comentários

A classe de CMFCRibbonBaseElement define as propriedades que são comuns a todos os elementos de fita que incluem a identificação do comando, um rótulo de texto, o texto de tooltip, a descrição do elemento, e o estado (que pode ser focalizado, realçada, pressionado, desativado, verificado, solto ou para baixo).

O tamanho da imagem de um elemento de fita é definido pelo membro de RibbonImageType , que pode ser um dos seguintes valores:

• RibbonImageLarge

• RibbonImageSmall

Dependendo seu tamanho, um elemento de fita exibe uma imagem pequena ou grande.

Exemplo

O exemplo a seguir demonstra como usar vários métodos na classe de CMFCRibbonBaseElement . O exemplo a seguir mostra como obter um objeto de CMFCRibbonBaseElement de uma classe de CMFCRibbonStatusBar , defina a descrição para o elemento de fita, define o texto, defina um keytip, e defina o texto de dica de ferramenta para o elemento de fita. Este trecho de código é parte de Exemplo do cliente de desenho.

   // CMFCRibbonStatusBar m_wndStatusBar
    CMFCRibbonBaseElement* pPane = m_wndStatusBar.FindByID(nID);


...


        pPane->SetDescription(_T("a pane"));
        // CString strText
        pPane->SetText(strText);
        pPane->SetKeys(_T("p"));
        pPane->SetToolTipText(_T("this is a pane"));

Hierarquia de herança

CObject

   CMFCRibbonBaseElement

Requisitos

Cabeçalho: afxbaseribbonelement.h

Consulte também

Referência

Gráfico da hierarquia

Outros recursos

Classes MFC