Partilhar via


CMFCRibbonPanel::SetElementRTCByID

Adiciona um elemento de fita que é especificado pela classe de informações fornecidas em tempo de execução para o painel de fita.

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

Parâmetros

  • [in] uiCmdID
    Especifica a identificação de comando do elemento de fita para adicionar.

  • [in] [out] pRTC
    Um ponteiro para informações da classe de 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 informações da classe especificada em tempo de execução.

Comentários

Se você deseja adicionar um elemento personalizado (por exemplo, um botão de cor) para o painel de fita, você deve especificar informações de classe de tempo de execução de elementos.A fita armazena estas informações, cria o elemento personalizado, e substitui um elemento existente posicionado por certo ID de comandoEntão retorna um ponteiro para o elemento recém-criado.

Exemplo

O exemplo a seguir mostra como usar o método de SetElementRTCByID :

// 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

Consulte também

Referência

Classe de CMFCRibbonPanel

Gráfico de hierarquia