Partager via


CMFCRibbonPanel::SetElementRTCByID

Ajoute un élément ruban qui est spécifié par les informations fournies de classe de runtime dans le panneau de ruban.

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

Paramètres

  • [in] uiCmdID
    Spécifie l'ID de commande de l'élément ruban pour ajouter.

  • [in] [out] pRTC
    Un pointeur vers des informations de classe d'exécution associé à l'élément ruban qui est ajouté au panneau de ruban.

Valeur de retour

L'élément ruban créé à l'aide de les informations spécifiées de classe d'exécution.

Notes

Si vous souhaitez ajouter un élément personnalisé (par exemple, un bouton de couleur) dans le panneau de ruban, vous devez spécifier les informations de la classe du runtime d'éléments personnalisés. Le ruban stocke ces informations, crée l'élément personnalisé, et remplace un élément existant défini en l'ID de commande spécifiée Il retourne ensuite un pointeur vers l'élément récemment créée.

Exemple

L'exemple suivant illustre l'utilisation de la méthode 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));

Configuration requise

en-tête : afxRibbonPanel.h

Voir aussi

Référence

CMFCRibbonPanel, classe

Graphique de la hiérarchie