Compartilhar via


CMFCRibbonBar::FindByID

Localiza um elemento da faixa de opções que possui a ID do comando especificado.

CMFCRibbonBaseElement* FindByID(
   UINT uiCmdID,
   BOOL bVisibleOnly=TRUE,
   BOOL bExcludeQAT=FALSE 
) const;

Parâmetros

  • [in] uiCmdID
    Especifica a ID do comando pela qual localizar o elemento da faixa de opções.

  • [in] bVisibleOnly
    If TRUE, somente a lista de elementos visíveis será pesquisada.

  • [in] bExcludeQAT
    If TRUE, excluir os elementos da barra de ferramentas de acesso rápido.

Valor de retorno

Um ponteiro válido para o elemento da faixa de opções que possui a ID do comando especificado ou NULL, se o elemento que possui a ID do comando especificado não existe ou o elemento não estiver visível e bVisibleOnly sinalizar de TRUE.

Comentários

Um elemento da faixa de opções é qualquer controle da faixa de opções que pode ser adicionado à faixa de opções, sistema autônomo um botão da faixa de opções, ou uma categoria da fita ou um controle deslizante da faixa de opções.

Use este método para localizar um elemento da faixa de opções por sua ID de comando.Em geral, pode haver mais de um elemento que possui uma ID especificada.Se desejar obter ponteiros para todos os elementos que usar uma ID especificada, use o CMFCRibbonBar::GetElementsByID método.

Requisitos

Cabeçalho: afxribbonbar.h

Consulte também

Conceitos

Gráfico de hierarquia do MFC

Referência

Classe CMFCRibbonBar