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éeIl 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

Classe de CMFCRibbonPanel

Graphique de la hiérarchie