CMFCToolBarComboBoxButton, classe
Bouton de barre d’outils qui contient un contrôle de zone de liste modifiable ( classe CComboBox).
Syntaxe
class CMFCToolBarComboBoxButton : public CMFCToolBarButton
Membres
Constructeurs publics
| Nom | Description |
|---|---|
| CMFCToolBarComboBoxButton ::CMFCToolBarComboBoxButton | Construit un objet CMFCToolBarComboBoxButton. |
Méthodes publiques
| Nom | Description |
|---|---|
| CMFCToolBarComboBoxButton ::AddItem | Ajoute un élément à la fin de la liste des zones de liste déroulante. |
| CMFCToolBarComboBoxButton ::AddSortedItem | Ajoute un élément à la liste des zones de liste déroulante. L’ordre des éléments de la liste est spécifié par Compare. |
| CMFCToolBarComboBoxButton ::Compare | Compare deux éléments. Appelé pour trier les éléments qui AddSortedItems s’ajoutent à la liste des zones de liste déroulante. |
| CMFCToolBarComboBoxButton ::CreateEdit | Crée un contrôle d’édition pour le bouton zone de liste modifiable. |
| CMFCToolBarComboBoxButton ::D eleteItem | Supprime un élément de la liste des zones de liste déroulante. |
| CMFCToolBarComboBoxButton ::FindItem | Retourne l’index de l’élément qui contient une chaîne spécifiée. |
| CMFCToolBarComboBoxButton ::GetByCmd | Retourne un pointeur vers le bouton de zone de liste modifiable avec un ID de commande spécifié. |
| CMFCToolBarComboBoxButton ::GetComboBox | Retourne un pointeur vers le contrôle de zone de liste modifiable incorporé dans le bouton de zone de liste modifiable. |
| CMFCToolBarComboBoxButton ::GetCount | Retourne le nombre d’éléments dans la liste des zones de liste déroulante. |
| CMFCToolBarComboBoxButton ::GetCountAll | Recherche le bouton de zone de liste modifiable qui a un ID de commande spécifié. Retourne le nombre d’éléments dans la liste des zones de liste déroulante de ce bouton. |
| CMFCToolBarComboBoxButton ::GetCurSel | Retourne l’index de l’élément sélectionné dans la liste des zones de liste déroulante. |
| CMFCToolBarComboBoxButton ::GetCurSelAll | Recherche le bouton de zone de liste modifiable qui a un ID de commande spécifié et retourne l’index de l’élément sélectionné dans la liste des zones de liste déroulante de ce bouton. |
| CMFCToolBarComboBoxButton ::GetEditCtrl | Retourne un pointeur vers le contrôle d’édition incorporé dans le bouton de zone de liste modifiable. |
| CMFCToolBarComboBoxButton ::GetItem | Retourne la chaîne associée à un index spécifié dans la liste des zones de liste déroulante. |
| CMFCToolBarComboBoxButton ::GetItemAll | Recherche le bouton de zone de liste modifiable qui a un ID de commande spécifié et retourne la chaîne associée à un index dans la liste des zones de liste déroulante de ce bouton. |
| CMFCToolBarComboBoxButton ::GetItemData | Retourne la valeur 32 bits associée à un index spécifié dans la liste des zones de liste déroulante. |
| CMFCToolBarComboBoxButton ::GetItemDataAll | Recherche le bouton de zone de liste modifiable qui a un ID de commande spécifié et retourne la valeur 32 bits associée à un index dans la liste des zones de liste déroulante de ce bouton. |
| CMFCToolBarComboBoxButton ::GetItemDataPtrAll | Recherche le bouton de zone de liste modifiable qui a un ID de commande spécifié. Récupère la valeur 32 bits associée à un index dans la liste des zones de liste déroulante de ce bouton et retourne la valeur 32 bits en tant que pointeur. |
| CMFCToolBarComboBoxButton ::GetText | Retourne le texte du contrôle d’édition de la zone de liste déroulante. |
| CMFCToolBarComboBoxButton ::GetTextAll | Recherche le bouton de zone de liste modifiable qui a un ID de commande spécifié et retourne le texte du contrôle d’édition de ce bouton. |
| CMFCToolBarComboBoxButton ::IsCenterVert | Détermine si les boutons de zone de liste modifiable de l’application sont centrés ou alignés en haut de la barre d’outils. |
| CMFCToolBarComboBoxButton ::IsFlatMode | Détermine si les boutons de zone de liste modifiable de l’application ont une apparence plate. |
| CMFCToolBarComboBoxButton ::RemoveAllItems | Supprime tous les éléments de la zone de liste et modifie le contrôle de la zone de liste modifiable. |
| CMFCToolBarComboBoxButton ::SelectItem | Sélectionne un élément dans la zone de liste modifiable en fonction de son index, de sa valeur 32 bits ou de sa chaîne, et avertit le contrôle de zone de liste modifiable sur la sélection. |
| CMFCToolBarComboBoxButton ::SelectItemAll | Recherche le bouton de zone de liste modifiable qui a un ID de commande spécifié. Appelle SelectItem à sélectionner un élément dans la zone de liste déroulante de ce bouton en fonction de sa chaîne, de son index ou de sa valeur 32 bits. |
| CMFCToolBarComboBoxButton ::SetCenterVert | Spécifie si les boutons de zone de liste modifiable de l’application sont centrés verticalement ou alignés en haut de la barre d’outils. |
| CMFCToolBarComboBoxButton ::SetDropDownHeight | Définit la hauteur de la zone de liste déroulante. |
| CMFCToolBarComboBoxButton ::SetFlatMode | Spécifie si les boutons de zone de liste modifiable de l’application ont une apparence plate. |
Notes
Pour ajouter un bouton de zone de liste modifiable à une barre d’outils, procédez comme suit :
Réservez un ID de ressource factice pour le bouton dans la ressource de la barre d'outils parente.
Construisez un
CMFCToolBarComboBoxButtonobjet.Dans le gestionnaire de messages qui traite le message AFX_WM_RESETTOOLBAR, remplacez le bouton factice par le nouveau bouton de zone de liste modifiable à l’aide de CMFCToolBar ::ReplaceButton.
Pour plus d’informations, consultez Procédure pas à pas : Mise en place de contrôles dans les barres d’outils. Pour obtenir un exemple de bouton de barre d’outils de zone de liste déroulante, consultez l’exemple de projet VisualStudioDemo.
Exemple
L’exemple suivant montre comment utiliser différentes méthodes de la classe CMFCToolBarComboBoxButton . L’exemple montre comment activer les zones de modification et de liste modifiable, définir la position verticale des boutons de zone de liste modifiable dans l’application, définir la hauteur de la zone de liste lorsqu’elle est supprimée, définir l’apparence plate des boutons de zone de liste modifiable dans l’application et définir le texte dans la zone d’édition du bouton de zone de liste modifiable. Cet extrait de code fait partie de l’exemple de démonstration Visual Studio.
// CObList listButtons
// POSITION posCombo
CMFCToolBarComboBoxButton* pCombo = DYNAMIC_DOWNCAST(CMFCToolBarComboBoxButton, listButtons.GetNext(posCombo));
pCombo->EnableWindow(true);
pCombo->SetCenterVert();
pCombo->SetDropDownHeight(25);
pCombo->SetFlatMode();
pCombo->SetText(_T("this is a combo box"));
Hiérarchie d'héritage
Spécifications
En-tête : afxtoolbarcomboboxbutton.h
CMFCToolBarComboBoxButton ::AddItem
Ajoute un élément unique à la zone de liste.
virtual INT_PTR AddItem(
LPCTSTR lpszItem,
DWORD_PTR dwData=0);
Paramètres
lpszItem
[in] Texte de l’élément à ajouter à la zone de liste.
dwData
[in] Données associées à l’élément à ajouter à la zone de liste.
Valeur de retour
Index du dernier élément dans la zone de liste.
Notes
N’utilisez pas cette méthode lorsque le style de zone de liste est trié.
Si le texte de l’élément se trouve déjà dans la zone de liste, les nouvelles données sont stockées avec l’élément existant. La recherche de l’élément respecte la casse.
CMFCToolBarComboBoxButton ::AddSortedItem
Ajoute un élément à la zone de liste dans l’ordre défini par la méthode Compare .
virtual INT_PTR AddSortedItem(
LPCTSTR lpszItem,
DWORD_PTR dwData=0);
Paramètres
lpszItem
[in] Texte de l’élément à ajouter à la zone de liste.
dwData
[in] Données associées à l’élément à ajouter à la zone de liste.
Valeur de retour
Index de l’élément ajouté à la zone de liste.
Notes
Utilisez cette fonction pour ajouter des éléments à la zone de liste dans un ordre spécifique.
CMFCToolBarComboBoxButton ::CanBeStretched
Indique si la taille du bouton de zone de liste modifiable peut changer.
virtual BOOL CanBeStretched() const;
Valeur de retour
Retourne TRUE.
CMFCToolBarComboBoxButton ::CMFCToolBarComboBoxButton
Construit un objet CMFCToolBarComboBoxButton .
CMFCToolBarComboBoxButton(
UINT uiID,
int iImage,
DWORD dwStyle=CBS_DROPDOWNLIST,
int iWidth=0);
Paramètres
uiID
[in] ID de commande du nouveau bouton.
iImage
[in] Index d’image de l’image associée au nouveau bouton.
dwStyle
[in] Style du nouveau bouton.
iWidth
[in] Largeur, en pixels, du nouveau bouton.
Notes
La largeur par défaut est de 150 pixels.
Pour obtenir la liste des styles de boutons de barre d’outils, voir Styles de contrôle ToolBar
CMFCToolBarComboBoxButton ::ClearData
Supprime les données définies par l’utilisateur.
virtual void ClearData();
Notes
Par défaut, cette méthode ne fait rien. Remplacez cette méthode dans une classe dérivée si vous souhaitez supprimer des données définies par l’utilisateur.
CMFCToolBarComboBoxButton ::Compare
Compare deux chaînes.
virtual int Compare(
LPCTSTR lpszItem1,
LPCTSTR lpszItem2);
Paramètres
lpszItem1
[in] Première chaîne à comparer.
lpszItem2
[in] Deuxième chaîne à comparer.
Valeur de retour
Valeur qui indique la relation lexicographique sensible à la casse entre les chaînes. Le tableau suivant répertorie les valeurs de sortie possibles :
| Value | Description |
|---|---|
| <0 | La première chaîne est inférieure à la seconde. |
| 0 | La première chaîne est égale à la seconde. |
| >0 | La première chaîne est supérieure à la seconde. |
Notes
Remplacez cette méthode pour modifier la façon dont les éléments sont triés dans la zone de liste.
La comparaison respecte la casse.
Cette méthode est appelée uniquement à partir de la méthode AddSortedItem .
CMFCToolBarComboBoxButton ::CopyFrom
Copie l’état de l’objet spécifié CMFCToolBarComboBoxButton dans l’objet actif.
virtual void CopyFrom(const CMFCToolBarButton& src);
Paramètres
src
[in] Objet source CMFCToolBarComboBoxButton .
CMFCToolBarComboBoxButton ::CreateCombo
Crée une zone de liste modifiable pour le bouton de zone de liste modifiable.
virtual CComboBox* CreateCombo(
CWnd* pWndParent,
const CRect& rect);
Paramètres
pWndParent
[in] Pointeur vers la fenêtre parente du bouton.
Rect
[in] Rectangle englobant de la zone de liste modifiable.
Valeur de retour
Pointeur vers la nouvelle zone de liste modifiable si la méthode a réussi ; sinon, NULL.
CMFCToolBarComboBoxButton ::CreateEdit
Crée une zone d’édition pour le bouton de zone de liste modifiable.
virtual CMFCToolBarComboBoxEdit* CreateEdit(
CWnd* pWndParent,
const CRect& rect,
DWORD dwEditStyle);
Paramètres
pWndParent
[in] Pointeur vers la fenêtre parente du bouton.
Rect
[in] Rectangle englobant de la nouvelle zone d’édition.
dwEditStyle
[in] Style de contrôle de la nouvelle zone d’édition.
Valeur de retour
Pointeur vers la nouvelle zone d’édition si la méthode a réussi ; sinon, NULL.
Notes
L’infrastructure appelle cette méthode lorsqu’elle crée une zone d’édition pour un bouton de zone de liste modifiable. Remplacez cette méthode pour modifier la façon dont CMFCToolBarComboBoxEdit est créé.
CMFCToolBarComboBoxButton ::D eleteItem
Supprime un élément spécifié de la zone de liste.
BOOL DeleteItem(int iIndex);
BOOL DeleteItem(DWORD_PTR dwData);
BOOL DeleteItem(LPCTSTR lpszText);
Paramètres
iIndex
[in] Index de base zéro de l’élément à supprimer.
dwData
[in] Données associées à l’élément à supprimer.
lpszText
[in] Texte de l’élément à supprimer. S’il existe plusieurs éléments avec le même texte, le premier élément est supprimé.
Valeur de retour
TRUE si l’élément a été localisé et supprimé avec succès ; sinon, FALSE.
Notes
CMFCToolBarComboBoxButton ::D uplicateData
Dupliquer les données définies par l’utilisateur.
virtual void DuplicateData();
Notes
Par défaut, cette méthode ne fait rien. Remplacez cette méthode dans une classe dérivée si vous souhaitez copier des données définies par l’utilisateur.
CMFCToolBarComboBoxButton ::EnableWindow
Active ou désactive les zones de modification et de liste modifiable.
virtual void EnableWindow(BOOL bEnable = TRUE);
Paramètres
bEnable
[in] TRUE pour activer les zones de modification et de liste modifiable ; FALSE pour désactiver les zones de modification et de liste modifiable.
Notes
En cas de désactivation, les contrôles ne peuvent pas devenir actifs et ne peuvent pas accepter l’entrée utilisateur.
CMFCToolBarComboBoxButton ::ExportToMenuButton
Copie une chaîne du tableau de chaînes d’application dans le menu spécifié à l’aide de l’ID de commande du bouton de zone de liste modifiable.
virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;
Paramètres
menuButton
[out] Référence à un bouton de menu.
Valeur de retour
Toujours TRUE.
CMFCToolBarComboBoxButton ::FindItem
Retourne l’index du premier élément de la zone de liste qui contient une chaîne spécifiée.
int FindItem(LPCTSTR lpszText) const;
Paramètres
lpszText
[in] Texte pour lequel effectuer une recherche dans la zone de liste.
Valeur de retour
Index de l’élément ; ou CB_ERR si l’élément est introuvable.
Notes
CMFCToolBarComboBoxButton ::GetByCmd
Obtient un pointeur vers le bouton de zone de liste modifiable qui a un ID de commande spécifié.
static CMFCToolBarComboBoxButton* GetByCmd(
UINT uiCmd,
BOOL bIsFocus=FALSE);
Paramètres
uiCmd
[in] ID de commande d’un bouton de zone de liste modifiable.
bIsFocus
[in] TRUE pour rechercher uniquement les boutons ciblés ; FALSE pour rechercher tous les boutons.
Valeur de retour
Pointeur vers un bouton de zone de liste modifiable ; ou NULL si le bouton est introuvable.
Notes
CMFCToolBarComboBoxButton ::GetComboBox
Retourne un pointeur vers la zone de liste modifiable dans le bouton de zone de liste modifiable.
CComboBox* GetComboBox() const;
Valeur de retour
Pointeur vers l’objet CComboBox Class si la méthode a réussi ; sinon NULL.
Notes
CMFCToolBarComboBoxButton ::GetContextMenuID
Obtient l’ID de ressource du menu contextuel pour le bouton zone de liste modifiable.
UINT GetContextMenuID();
Valeur de retour
ID de ressource du menu contextuel.
CMFCToolBarComboBoxButton ::GetCount
Retourne le nombre d’éléments dans la zone de liste.
INT_PTR GetCount() const;
Valeur de retour
Nombre d’éléments dans la zone de liste.
Notes
CMFCToolBarComboBoxButton ::GetCountAll
Obtient le nombre d’éléments dans la zone de liste d’un bouton de zone de liste modifiable qui a un ID de commande spécifié.
static int GetCountAll(UINT uiCmd);
Paramètres
uiCmd
[in] ID de commande d’un bouton de zone de liste modifiable.
Valeur de retour
Nombre d’éléments dans la zone de liste ; sinon, CB_ERR si le bouton zone de liste modifiable est introuvable.
Notes
CMFCToolBarComboBoxButton ::GetCurSel
Obtient l’index de l’élément actuellement sélectionné dans la zone de liste.
int GetCurSel() const;
Valeur de retour
Index de l’élément actuellement sélectionné dans la zone de liste ; ou CB_ERR si aucun élément n’est sélectionné.
Notes
L’index de zone de liste est de base zéro.
CMFCToolBarComboBoxButton ::GetCurSelAll
Retourne l’index de l’élément actuellement sélectionné dans la zone de liste d’un bouton de zone de liste modifiable qui a un ID de commande spécifié.
static int GetCurSelAll(UINT uiCmd);
Paramètres
uiCmd
[in] ID de commande d’un bouton de zone de liste modifiable.
Valeur de retour
Index de l’élément actuellement sélectionné dans la zone de liste ; sinon, CB_ERR si aucun élément n’est sélectionné ou qu’un bouton de zone de liste modifiable est introuvable.
Notes
L’index de zone de liste est de base zéro.
CMFCToolBarComboBoxButton ::GetEditCtrl
Retourne un pointeur vers la zone d’édition dans le bouton de zone de liste modifiable.
virtual CEdit* GetEditCtrl();
Valeur de retour
Pointeur vers la zone d’édition si la méthode a réussi ; sinon, NULL.
Notes
CMFCToolBarComboBoxButton ::GetHwnd
Retourne le handle de fenêtre pour la zone de liste déroulante.
virtual HWND GetHwnd();
Valeur de retour
Handle de fenêtre, ou NULL si la zone de liste modifiable n’est pas associée à un objet fenêtre.
CMFCToolBarComboBoxButton ::GetItem
Retourne la chaîne associée à un élément à un index spécifié dans la zone de liste.
LPCTSTR GetItem(int iIndex=-1) const;
Paramètres
iIndex
[in] Index de base zéro d’un élément dans la zone de liste.
Valeur de retour
Pointeur vers la chaîne associée à l’élément ; sinon, NULL si le paramètre d’index n’est pas valide ou si le paramètre d’index est -1 et qu’il n’existe aucun élément sélectionné dans la zone de liste déroulante.
Notes
Un paramètre d’index de -1 retourne la chaîne de l’élément actuellement sélectionné.
CMFCToolBarComboBoxButton ::GetItemAll
Retourne la chaîne associée à un élément à un index spécifié dans la zone de liste d’un bouton de zone de liste modifiable qui a un ID de commande spécifié.
static LPCTSTR GetItemAll(
UINT uiCmd,
int iIndex=-1);
Paramètres
uiCmd
[in] ID de commande d’un bouton de zone de liste modifiable.
iIndex
[in] Index de base zéro d’un élément dans la zone de liste.
Valeur de retour
Pointeur vers la chaîne de l’élément si la méthode a réussi ; sinon, NULL si l’index n’est pas valide, un bouton de zone de liste modifiable est introuvable ou si l’index est -1 et qu’il n’y a pas d’élément sélectionné dans la zone de liste déroulante.
Notes
Une valeur d’index de -1 retourne la chaîne de l’élément actuellement sélectionné.
CMFCToolBarComboBoxButton ::GetItemData
Retourne les données associées à un élément à un index spécifique dans la zone de liste.
DWORD_PTR GetItemData(int iIndex=-1) const;
Paramètres
iIndex
[in] Index de base zéro d’un élément dans la zone de liste.
Valeur de retour
Données associées à l’élément ; ou 0 si l’élément n’existe pas.
Notes
Un paramètre d’index de -1 retourne les données associées à l’élément actuellement sélectionné.
CMFCToolBarComboBoxButton ::GetItemDataAll
Retourne les données associées à un élément à un index spécifique dans la zone de liste d’un bouton de zone de liste modifiable qui a un ID de commande spécifique.
static DWORD_PTR GetItemDataAll(
UINT uiCmd,
int iIndex=-1);
Paramètres
uiCmd
[in] ID de commande d’un bouton de zone de liste modifiable.
iIndex
[in] Index de base zéro d’un élément dans la zone de liste.
Valeur de retour
Données associées à l’élément si la méthode a réussi ; sinon, 0 si l’index spécifié n’est pas valide ou CB_ERR si le bouton de zone de liste modifiable est introuvable.
Notes
Un paramètre d’index de -1 retourne les données associées à l’élément actuellement sélectionné.
CMFCToolBarComboBoxButton ::GetItemDataPtrAll
Retourne les données associées à un élément à un index spécifique dans la zone de liste d’un bouton de zone de liste modifiable qui a un ID de commande spécifique. Ces données sont retournées en tant que pointeur.
static void* GetItemDataPtrAll(
UINT uiCmd,
int iIndex=-1);
Paramètres
uiCmd
[in] ID de commande du bouton zone de liste modifiable.
iIndex
[in] Index de base zéro d’un élément dans la zone de liste.
Valeur de retour
Pointeur associé à l’élément si la méthode a réussi ; sinon, -1 si une erreur se produit ou NULL si le bouton de zone de liste modifiable est introuvable.
Notes
CMFCToolBarComboBoxButton ::GetPrompt
Retourne la chaîne d’invite pour le bouton de zone de liste modifiable.
virtual CString GetPrompt() const;
Valeur de retour
Chaîne d’invite.
Notes
Cette méthode n’est actuellement pas implémentée.
CMFCToolBarComboBoxButton ::GetText
Obtient le texte de la zone d’édition.
LPCTSTR GetText() const;
Valeur de retour
Texte de la zone d’édition.
Notes
CMFCToolBarComboBoxButton ::GetTextAll
Obtient le texte dans la zone d’édition d’un bouton de zone de liste modifiable qui a un ID de commande spécifié.
static LPCTSTR GetTextAll(UINT uiCmd);
Paramètres
uiCmd
[in] ID de commande d’un bouton de zone de liste modifiable spécifique.
Valeur de retour
Texte de la zone d’édition si la méthode a réussi ; sinon, NULL.
Notes
CMFCToolBarComboBoxButton ::HasFocus
Indique si la zone de liste modifiable a actuellement le focus.
virtual BOOL HasFocus() const;
Valeur de retour
TRUE si la zone de liste modifiable a actuellement le focus ; sinon, FALSE.
Notes
Cette méthode retourne également TRUE si une fenêtre enfant de la zone de liste modifiable a actuellement le focus.
CMFCToolBarComboBoxButton ::IsCenterVert
Retourne la position verticale des boutons de zone de liste modifiable dans l’application.
static BOOL IsCenterVert();
Valeur de retour
TRUE si les boutons sont centrés ; FALSE si les boutons sont alignés en haut.
Notes
CMFCToolBarComboBoxButton ::IsFlatMode
Retourne l’apparence de style plat des boutons de zone de liste modifiable dans l’application.
static BOOL IsFlatMode();
Valeur de retour
TRUE si les boutons ont un style plat ; sinon, FALSE.
Notes
Le style plat par défaut pour les boutons de zone de liste modifiable est FALSE.
CMFCToolBarComboBoxButton ::IsOwnerOf
Indique si le handle spécifié est associé au bouton de zone de liste modifiable ou à l’un de ses enfants.
virtual BOOL IsOwnerOf(HWND hwnd);
Paramètres
Hwnd
[in] Handle de fenêtre.
Valeur de retour
TRUE si la poignée est assocée avec le bouton de zone de liste modifiable ou l’un de ses enfants ; sinon, FALSE.
CMFCToolBarComboBoxButton ::IsRibbonButton
Indique si le bouton de zone de liste modifiable réside dans un panneau de ruban.
BOOL IsRibbonButton() const;
Valeur de retour
Toujours FALSE.
Notes
Par défaut, cette méthode retourne toujours FALSE, ce qui signifie que le bouton zone de liste modifiable n’est jamais affiché sur un panneau de ruban.
CMFCToolBarComboBoxButton ::IsWindowVisible
Retourne l’état de visibilité du bouton de zone de liste modifiable.
virtual BOOL IsWindowVisible();
Valeur de retour
État de visibilité du bouton de zone de liste modifiable.
CMFCToolBarComboBoxButton ::NotifyCommand
Indique si le bouton de zone de liste modifiable traite le message.
virtual BOOL NotifyCommand(int iNotifyCode);
Paramètres
iNotifyCode
[in] Message de notification associé à la commande.
Valeur de retour
Indique si le bouton de zone de liste modifiable traite le message.
CMFCToolBarComboBoxButton ::OnAddToCustomizePage
Appelé par l’infrastructure lorsque le bouton est ajouté à la boîte de dialogue Personnaliser .
virtual void OnAddToCustomizePage();
CMFCToolBarComboBoxButton ::OnCalculateSize
Appelé par l’infrastructure pour calculer la taille du bouton.
virtual SIZE OnCalculateSize(
CDC* pDC,
const CSize& sizeDefault,
BOOL bHorz);
Paramètres
pDC
[in] Contexte de l’appareil qui affiche le bouton de zone de liste modifiable.
sizeDefault
[in] Taille par défaut du bouton zone de liste modifiable.
bHorz
[in] État d’ancrage de la barre d’outils parente. TRUE lorsque la barre d’outils est ancrée horizontalement et FALSE lorsque la barre d’outils est ancrée verticalement.
Valeur de retour
Structure SIZE qui contient les dimensions du bouton zone de liste modifiable, en pixels.
CMFCToolBarComboBoxButton ::OnChangeParentWnd
Appelé par l’infrastructure lorsque le bouton de zone de liste modifiable est inséré dans une nouvelle barre d’outils.
virtual void OnChangeParentWnd(CWnd* pWndParent);
Paramètres
pWndParent
[in] Pointeur vers la nouvelle barre d’outils parente.
CMFCToolBarComboBoxButton ::OnClick
Appelé par l’infrastructure lorsque l’utilisateur clique sur le bouton de zone de liste modifiable.
virtual BOOL OnClick(
CWnd* pWnd,
BOOL bDelay = TRUE);
Paramètres
Pwnd
[in] Pointeur vers la fenêtre parente du bouton zone de liste modifiable.
bDelay
[in] Réservé à une utilisation dans une classe dérivée.
Valeur de retour
TRUE si la méthode gère l’événement ; sinon, FALSE.
CMFCToolBarComboBoxButton ::OnCtlColor
Appelé par l’infrastructure lorsque l’utilisateur modifie la couleur de la barre d’outils parente pour définir la couleur du bouton de zone de liste modifiable.
virtual HBRUSH OnCtlColor(
CDC* pDC,
UINT nCtlColor);
Paramètres
pDC
[in] Contexte de l’appareil qui affiche le bouton de zone de liste modifiable.
nCtlColor
[in] Inutilisé.
Valeur de retour
Gérez le pinceau que l’infrastructure utilise pour peindre l’arrière-plan du bouton de zone de liste modifiable.
Notes
Cette méthode définit également la couleur de texte du bouton de zone de liste modifiable.
CMFCToolBarComboBoxButton ::OnDraw
Appelé par l’infrastructure pour dessiner le bouton de zone de liste modifiable à l’aide des styles et options spécifiés.
virtual void OnDraw(
CDC* pDC,
const CRect& rect,
CMFCToolBarImages* pImages,
BOOL bHorz = TRUE,
BOOL bCustomizeMode = FALSE,
BOOL bHighlight = FALSE,
BOOL bDrawBorder = TRUE,
BOOL bGrayDisabledButtons = TRUE);
Paramètres
Pdc
[in] Contexte de l’appareil qui affiche le bouton.
Rect
[in] Rectangle englobant du bouton.
pImages
[in] Collection d’images associée au bouton.
bHorz
[in] État d’ancrage de la barre d’outils parente. TRUE lorsque la barre d’outils est ancrée horizontalement et FALSE lorsque la barre d’outils est ancrée verticalement.
bCustomizeMode
[in] Indique si l’application est en mode de personnalisation.
bHighlight
[in] Indique s’il faut dessiner le bouton de zone de liste modifiable mis en surbrillance.
bDrawBorder
[in] Indique s’il faut dessiner le bouton de zone de liste modifiable avec une bordure.
bGrayDisabledButtons
[in] TRUE pour dessiner des boutons désactivés ombrés ; FALSE pour utiliser la collection d’images désactivées.
CMFCToolBarComboBoxButton ::OnDrawOnCustomizeList
Appelé par l’infrastructure pour dessiner le bouton de zone de liste modifiable dans le volet Commandes de la boîte de dialogue Personnaliser .
virtual int OnDrawOnCustomizeList(
CDC* pDC,
const CRect& rect,
BOOL bSelected);
Paramètres
pDC
[in] Contexte de l’appareil qui affiche le bouton de zone de liste modifiable.
Rect
[in] Rectangle englobant du bouton de zone de liste modifiable.
bSelected
[in] TRUE si le bouton de zone de liste modifiable est sélectionné ; sinon, FALSE.
Valeur de retour
Largeur, en pixels, du bouton zone de liste modifiable.
CMFCToolBarComboBoxButton ::OnGlobalFontsChanged
Appelé par l’infrastructure pour définir la police du bouton de zone de liste modifiable lorsque la police de l’application change.
virtual void OnGlobalFontsChanged();
CMFCToolBarComboBoxButton ::OnMove
Appelé par l’infrastructure pour modifier l’emplacement du bouton de zone de liste modifiable lorsque la barre d’outils parente se déplace.
virtual void OnMove();
CMFCToolBarComboBoxButton ::OnShow
Appelé par l’infrastructure lorsque le bouton de zone de liste modifiable est masqué ou affiché.
virtual void OnShow(BOOL bShow);
Paramètres
bShow
[in] Indique s’il faut masquer ou afficher le bouton de zone de liste modifiable.
CMFCToolBarComboBoxButton ::OnSize
Appelé par l’infrastructure pour modifier la taille du bouton de zone de liste modifiable lorsque la barre d’outils parente change de taille.
virtual void OnSize(int iSize);
Paramètres
iSize
[in] Nouvelle largeur du bouton de zone de liste modifiable.
CMFCToolBarComboBoxButton ::OnUpdateToolTip
Appelé par l’infrastructure lorsque l’utilisateur modifie l’info-bulle du bouton zone de liste modifiable.
virtual BOOL OnUpdateToolTip(
CWnd* pWndParent,
int iButtonIndex,
CToolTipCtrl& wndToolTip,
CString& str);
Paramètres
pWndParent
[in] Pointeur vers la fenêtre parente du bouton zone de liste modifiable.
iButtonIndex
[in] ID du bouton de zone de liste modifiable.
wndToolTip
[in] Info-bulle à associer au bouton de zone de liste modifiable.
str
[in] Texte de l’info-bulle.
Valeur de retour
TRUE si la méthode gère l’événement ; sinon, FALSE.
CMFCToolBarComboBoxButton ::RemoveAllItems
Supprime tous les éléments de la liste et des zones d’édition.
void RemoveAllItems();
Notes
Supprime tous les éléments de la zone de liste et modifie le contrôle d’une zone de liste modifiable.
CMFCToolBarComboBoxButton ::SelectItem
Sélectionne un élément dans la zone de liste.
BOOL SelectItem(
int iIndex,
BOOL bNotify=TRUE);
BOOL SelectItem(DWORD_PTR dwData);
BOOL SelectItem(LPCTSTR lpszText);
Paramètres
iIndex
[in] Index de base zéro d’un élément dans la zone de liste.
bNotify
[in] TRUE pour notifier le bouton de zone de liste modifiable de la sélection ; sinon FALSE.
dwData
[in] Données associées à un élément dans la zone de liste.
lpszText
[in] Texte d’un élément dans la zone de liste.
Valeur de retour
TRUE si la méthode a réussi ; sinon FALSE.
Notes
CMFCToolBarComboBoxButton ::SelectItemAll
Sélectionne un élément dans la zone de liste d’un bouton de zone de liste modifiable qui a un ID de commande spécifié.
static BOOL SelectItemAll(
UINT uiCmd,
int iIndex);
static BOOL SelectItemAll(
UINT uiCmd,
DWORD_PTR dwData);
static BOOL SelectItemAll(
UINT uiCmd,
LPCTSTR lpszText);
Paramètres
uiCmd
[in] ID de commande du bouton de zone de liste modifiable qui contient la zone de liste.
iIndex
[in] Index de base zéro de l’élément dans la zone de liste. La valeur -1 supprime toute sélection actuelle dans la zone de liste et efface la zone d’édition.
dwData
[in] Données d’un élément dans la zone de liste.
lpszText
[in] Texte d’un élément dans la zone de liste.
Valeur de retour
TRUE si la méthode a réussi ; sinon FALSE.
Notes
CMFCToolBarComboBoxButton ::Serialize
Lit cet objet à partir d’une archive ou l’écrit dans une archive.
virtual void Serialize(CArchive& ar);
Paramètres
Ar
[in, out] Objet CArchive à sérialiser.
Notes
Paramètres dans l’objet CArchive détermine si cette méthode lit ou écrit dans l’archive.
CMFCToolBarComboBoxButton ::SetACCData
Remplit l’objet spécifié CAccessibilityData à l’aide des données d’accessibilité à partir du bouton de zone de liste modifiable.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Paramètres
pParent
[in] Fenêtre parente du bouton de zone de liste modifiable.
data
[out] Objet CAccessibilityData qui reçoit les données d’accessibilité à partir du bouton zone de liste modifiable.
Valeur de retour
TRUE si la méthode a réussi ; sinon FALSE.
CMFCToolBarComboBoxButton ::SetCenterVert
Définit la position verticale des boutons de zone de liste modifiable dans l’application.
static void SetCenterVert(BOOL bCenterVert=TRUE);
Paramètres
bCenterVert
[in] TRUE pour centrer le bouton de zone de liste modifiable dans la barre d’outils ; FALSE pour aligner le bouton de zone de liste modifiable en haut de la barre d’outils.
Notes
Par défaut, les boutons de zone de liste modifiable sont alignés en haut.
CMFCToolBarComboBoxButton ::SetContextMenuID
Définit l’ID de ressource du menu contextuel pour le bouton zone de liste modifiable.
void SetContextMenuID(UINT uiResID);
Paramètres
uiResID
[in] ID de ressource du menu contextuel.
CMFCToolBarComboBoxButton ::SetDropDownHeight
Définit la hauteur de la zone de liste lorsqu’elle est supprimée.
void SetDropDownHeight(int nHeight);
Paramètres
nHeight
[in] Hauteur, en pixels, de la zone de liste.
Notes
La hauteur par défaut est de 150 pixels.
CMFCToolBarComboBoxButton ::SetFlatMode
Définit l’apparence de style plat des boutons de zone de liste modifiable dans l’application.
static void SetFlatMode(BOOL bFlat=TRUE);
Paramètres
bFlat
[in] TRUE pour une apparence de style plat ; sinon FALSE.
Notes
Le style plat par défaut pour les boutons de zone de liste modifiable est FALSE.
CMFCToolBarComboBoxButton ::SetStyle
Définit le style spécifié pour le bouton de zone de liste modifiable et redessine le contrôle s’il n’est pas désactivé.
virtual void SetStyle(UINT nStyle);
Paramètres
nStyle
[in] Combinaison au niveau du bit (OR) des styles de barre d’outils.
Notes
Pour obtenir la liste des styles de boutons de barre d’outils, voir Styles de contrôle ToolBar
CMFCToolBarComboBoxButton ::SetText
Définit le texte dans la zone d’édition du bouton de zone de liste modifiable.
void SetText(LPCTSTR lpszText);
Paramètres
lpszText
[in] Pointeur vers une chaîne qui contient le texte de la zone d’édition.
Voir aussi
Graphique hiérarchique
Classes
CMFCToolBarButton, classe
CComboBox, classe
CMFCToolBar ::ReplaceButton
Procédure pas à pas : placement de contrôles dans les barres d’outils
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour