CMFCRibbonPanel::SetElementRTCByID
Agrega un elemento cinta que es especificado por la información proporcionada de la clase en tiempo de ejecución al panel de la cinta de opciones.
CMFCRibbonBaseElement* SetElementRTCByID(
UINT uiCmdID,
CRuntimeClass* pRTC
);
Parámetros
[in] uiCmdID
Especifica el identificador del elemento cinta para agregar.[in] [out] pRTC
Un puntero a la información de clase del runtime asociado con el elemento cinta que se agrega al panel de la cinta de opciones.
Valor devuelto
El elemento cinta creado con la información especificada de la clase en tiempo de ejecución.
Comentarios
Si desea agregar un elemento personalizado (por ejemplo, un botón de color) al panel de la cinta de opciones, debe especificar la información de la clase en tiempo de ejecución del elemento personalizado. La cinta de opciones almacena esta información, crea el elemento personalizado, y reemplaza un elemento existente situado por identificador especificada de comando A continuación devuelve un puntero al elemento creado recientemente.
Ejemplo
En el siguiente ejemplo, se muestra cómo utilizar el método 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
encabezado: afxRibbonPanel.h