CMFCRibbonButtonsGroup, classe
La CMFCRibbonButtonsGroup
classe vous permet d’organiser un ensemble de boutons de ruban dans un groupe. Tous les boutons du groupe sont directement adjacents horizontalement et placés dans une bordure.
Syntaxe
class CMFCRibbonButtonsGroup : public CMFCRibbonBaseElement
Membres
Constructeurs publics
Nom | Description |
---|---|
CMFCRibbonButtonsGroup ::CMFCRibbonButtonsGroup | Construit un objet CMFCRibbonButtonsGroup . |
Méthodes publiques
Nom | Description |
---|---|
CMFCRibbonButtonsGroup ::AddButton | Ajoute un bouton à un groupe. |
CMFCRibbonButtonsGroup ::AddButtons | Ajoute une liste de boutons à un groupe. |
CMFCRibbonButtonsGroup ::GetButton | Retourne un pointeur vers le bouton situé à un index spécifié. |
CMFCRibbonButtonsGroup ::GetCount | Retourne le nombre de boutons dans le groupe. |
CMFCRibbonButtonsGroup ::GetImageSize | Renvoie la taille de l’image des images normales dans le groupe de ruban (remplace CMFCRibbonBaseElement ::GetImageSize.) |
CMFCRibbonButtonsGroup ::GetRegularSize | Renvoie la taille normale de l’élément de ruban (remplace CMFCRibbonBaseElement ::GetRegularSize.) |
CMFCRibbonButtonsGroup ::HasImages | Indique si l’objet contient des images de barre d’outils CMFCRibbonButtonsGroup . |
CMFCRibbonButtonsGroup ::OnDrawImage | Dessine l’image appropriée pour un bouton spécifié, selon que le bouton est normal, mis en surbrillance ou désactivé. |
CMFCRibbonButtonsGroup ::RemoveAll | Supprime tous les boutons de l’objet CMFCRibbonButtonsGroup . |
CMFCRibbonButtonsGroup ::SetImages | Affecte des images au groupe. |
CMFCRibbonButtonsGroup ::SetParentCategory | Définit le parent CMFCRibbonCategory de l’objet CMFCRibbonButtonsGroup et tous les boutons qu’il contient (remplace CMFCRibbonBaseElement ::SetParentCategory.) |
Notes
Le groupe est dérivé de CMFCBaseRibbonElement et peut être manipulé en tant qu’entité unique. Vous pouvez positionner le groupe sur n’importe quel panneau ou menu contextuel.
Exemple
L’exemple suivant montre comment utiliser différentes méthodes de la classe CMFCRibbonButtonsGroup
. L’exemple montre comment construire un CMFCRibbonButtonsGroup
objet, affecter des images au groupe de boutons du ruban et ajouter un bouton au groupe de boutons du ruban. Cet extrait de code fait partie de l’ exemple Draw Client.
CMFCRibbonButtonsGroup *pSBGroup = new CMFCRibbonButtonsGroup;
CMFCToolBarImages images;
images.SetImageSize(CSize(14, 14));
CMFCToolBarImages hotimages;
hotimages.SetImageSize(CSize(14, 14));
if (images.Load(IDB_STATUSBAR_1) && hotimages.Load(IDB_STATUSBAR_2))
{
pSBGroup->SetImages(&images, &hotimages, NULL);
}
pSBGroup->AddButton(new CMFCRibbonButton(ID_FILE_PRINT_PREVIEW, _T(""), 0));
pSBGroup->AddButton(new CMFCRibbonButton(ID_FILE_SUMMARYINFO, _T(""), 1));
// CMFCRibbonStatusBar m_wndStatusBar
m_wndStatusBar.AddExtendedElement(pSBGroup, _T("View Shortcuts"));
Hiérarchie d'héritage
Spécifications
En-tête : afxribbonbuttonsgroup.h
CMFCRibbonButtonsGroup ::AddButton
Ajoute un bouton à un groupe.
void AddButton(CMFCRibbonBaseElement* pButton);
Paramètres
pButton
[in] Pointeur vers un bouton à ajouter.
CMFCRibbonButtonsGroup ::AddButtons
Ajoute une liste de boutons à un groupe.
void AddButtons(
const CList<CMFCRibbonBaseElement*,CMFCRibbonBaseElement*>& lstButtons);
Paramètres
lstButtons
[in] Liste de pointeurs vers les boutons que vous souhaitez ajouter.
CMFCRibbonButtonsGroup ::CMFCRibbonButtonsGroup
Construit un objet CMFCRibbonButtonsGroup
.
CMFCRibbonButtonsGroup();
CMFCRibbonButtonsGroup(CMFCRibbonBaseElement* pButton);
Paramètres
pButton
[in] Spécifie un bouton à ajouter à l’objet nouvellement créé CMFCRibbonButtonsGroup
.
Valeur de retour
Notes
CMFCRibbonButtonsGroup ::GetButton
Retourne un pointeur vers le bouton situé à un index spécifié.
CMFCRibbonBaseElement* GetButton(int i) const;
Paramètres
i
[in] Index de base zéro d’un bouton à retourner.
Valeur de retour
Pointeur vers le bouton situé à l’index spécifié. NULL si l’index spécifié est hors plage.
Notes
CMFCRibbonButtonsGroup ::GetCount
Retourne le nombre de boutons dans le groupe.
int GetCount() const;
Valeur de retour
Nombre de boutons dans le groupe.
CMFCRibbonButtonsGroup ::GetImageSize
Récupère la taille de l’image source du membre m_Images
protégéCMFCToolBarImages
.
const CSize GetImageSize() const;
Valeur de retour
Retourne la taille de l’image source des images de barre d’outils, le cas échéant, ou une CSize
valeur égale à zéro si ce n’est pas le cas.
Notes
CMFCRibbonButtonsGroup ::GetRegularSize
Récupère la taille maximale possible de l’élément de groupe de ruban.
virtual CSize GetRegularSize(CDC* pDC);
Paramètres
pDC
[in] Pointeur vers le contexte de l’appareil du groupe de ruban.
Valeur de retour
Notes
CMFCRibbonButtonsGroup ::HasImages
Indique si l’objet contient des images de barre d’outils CMFCRibbonButtonsGroup
.
BOOL HasImages() const;
Valeur de retour
Retourne TRUE si le membre m_Images
protégé CMFCToolBarImages
contient des images, ou FALSE si ce n’est pas le cas.
Notes
CMFCRibbonButtonsGroup ::OnDrawImage
Dessine l’image appropriée pour un bouton spécifié, selon que le bouton est normal, mis en surbrillance ou désactivé.
virtual void OnDrawImage(
CDC* pDC,
CRect rectImage,
CMFCRibbonBaseElement* pButton,
int nImageIndex);
Paramètres
pDC
[in] Pointeur vers le contexte de l’appareil de l’objet CMFCRibbonButtonsGroup
.
rectImage
[in] Rectangle dans lequel dessiner l’image.
pButton
[in] Bouton pour lequel dessiner l’image.
nImageIndex
[in] Index de l’image à dessiner sur le bouton (dans l’un des trois tableaux d’images pour les boutons normaux, mis en surbrillance ou désactivés).
Notes
CMFCRibbonButtonsGroup ::RemoveAll
Supprime tous les boutons de l’objet CMFCRibbonButtonsGroup
.
void RemoveAll();
Notes
CMFCRibbonButtonsGroup ::SetImages
Affecte des images au groupe de boutons du ruban.
void SetImages(
CMFCToolBarImages* pImages,
CMFCToolBarImages* pHotImages,
CMFCToolBarImages* pDisabledImages);
Paramètres
pImages
[in] Images régulières.
pHotImages
[in] Images chaudes.
pDisabledImages
[in] Images désactivées.
Notes
Appelez SetImages
avant d’ajouter des boutons à un groupe. Le nombre d’images doit être supérieur ou égal au nombre de boutons à ajouter au groupe.
Remarque
Les images chaudes sont des images qui s’affichent lorsque l’utilisateur pointe sur le bouton. Les images désactivées sont des images affichées lorsque le bouton est désactivé.
CMFCRibbonButtonsGroup ::SetParentCategory
Définit le parent CMFCRibbonCategory
de l’objet CMFCRibbonButtonsGroup
et tous les boutons qu’il contient.
virtual void SetParentCategory(CMFCRibbonCategory* pCategory);
Paramètres
pCategory
[in] Pointeur vers la catégorie parente à définir (les groupes à onglets dans les contrôles du ruban sont appelés catégories).