CMFCRibbonPanel::SetElementRTCByID
Adiciona um elemento de faixa especificado pelas informações de classe em tempo de execução fornecida para o painel da faixa de opções.
CMFCRibbonBaseElement* SetElementRTCByID(
UINT uiCmdID,
CRuntimeClass* pRTC
);
Parâmetros
[in] uiCmdID
Especifica a ID de comando do elemento da faixa de opções para adicionar.[in] [out] pRTC
Um ponteiro para as informações de classe em tempo de execução associados ao elemento de faixa de opções é adicionado ao painel da faixa de opções.
Valor de retorno
O elemento da faixa de opções que foi criado usando as informações de classe em tempo de execução especificado.
Comentários
Se você quiser adicionar um elemento personalizado (por exemplo, um botão de cor) para o painel da faixa de opções, você deve especificar informações de classe do elemento personalizado em tempo de execução.A faixa de opções armazena essas informações, cria o elemento personalizado e substitui um elemento existente localizado, a ID do comando especificado.Em seguida, ele retorna um ponteiro para o elemento recém-criado.
Exemplo
O exemplo a seguir 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));
Requisitos
Cabeçalho: afxRibbonPanel.h