CMFCToolBarComboBoxButton, classe

Article
10/12/2023

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 CMFCToolBarComboBoxButton objet.
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

CObject

CMFCToolBarButton

CMFCToolBarComboBoxButton

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 :

Valeur	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

Les paramètres de l’objet CArchive déterminent 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

Partager via

CMFCToolBarComboBoxButton, classe

Syntaxe

Membres

Constructeurs publics

Méthodes publiques

Notes

Exemple

Hiérarchie d'héritage

Spécifications

CMFCToolBarComboBoxButton ::AddItem

Paramètres

Valeur de retour

Notes

CMFCToolBarComboBoxButton ::AddSortedItem

Paramètres

Valeur de retour

Notes

CMFCToolBarComboBoxButton ::CanBeStretched

Valeur de retour

CMFCToolBarComboBoxButton ::CMFCToolBarComboBoxButton

Paramètres

Notes

CMFCToolBarComboBoxButton ::ClearData

Notes

CMFCToolBarComboBoxButton ::Compare

Paramètres

Valeur de retour

Notes

CMFCToolBarComboBoxButton ::CopyFrom

Paramètres

CMFCToolBarComboBoxButton ::CreateCombo

Paramètres

Valeur de retour

CMFCToolBarComboBoxButton ::CreateEdit

Paramètres

Valeur de retour

Notes

CMFCToolBarComboBoxButton ::D eleteItem

Paramètres

Valeur de retour

Notes

CMFCToolBarComboBoxButton ::D uplicateData

Notes

CMFCToolBarComboBoxButton ::EnableWindow

Paramètres

Notes

CMFCToolBarComboBoxButton ::ExportToMenuButton

Paramètres

Valeur de retour

CMFCToolBarComboBoxButton ::FindItem

Paramètres

Valeur de retour

Notes

CMFCToolBarComboBoxButton ::GetByCmd

Paramètres

Valeur de retour

Notes

CMFCToolBarComboBoxButton ::GetComboBox

Valeur de retour

Notes

CMFCToolBarComboBoxButton ::GetContextMenuID

Valeur de retour

CMFCToolBarComboBoxButton ::GetCount

Valeur de retour

Notes

CMFCToolBarComboBoxButton ::GetCountAll

Paramètres

Valeur de retour

Notes

CMFCToolBarComboBoxButton ::GetCurSel

Valeur de retour

Notes

CMFCToolBarComboBoxButton ::GetCurSelAll

Paramètres

Valeur de retour

Notes

CMFCToolBarComboBoxButton ::GetEditCtrl

Valeur de retour

Notes