Partager via

Guide pratique pour créer un contrôle d’en-tête

  • Article

Cette rubrique montre comment créer un contrôle d’en-tête et le positionner dans la zone cliente de la fenêtre parente. Vous pouvez créer un contrôle d’en-tête à l’aide de la fonction CreateWindowEx et en spécifiant la classe de fenêtre WC_HEADER et les styles de contrôle d’en-tête appropriés. Cette classe de fenêtre est inscrite lors du chargement de la DLL de contrôle commun. Pour vous assurer que cette DLL est chargée, utilisez la fonction InitCommonControlsEx .

Bon à savoir

Technologies

Prérequis

  • C/C++
  • Programmation de l’interface utilisateur Windows

Instructions

L’exemple de code C++ suivant appelle d’abord la fonction InitCommonControlsEx pour charger la DLL de contrôle commun. Il appelle ensuite la fonction CreateWindowEx pour créer un contrôle d’en-tête. Le contrôle est initialement masqué. Le message HDM_LAYOUT est utilisé pour calculer la taille et la position du contrôle dans la fenêtre parente. Le contrôle est ensuite repositionné et rendu visible.

// DoCreateHeader - creates a header control that is positioned along 
//     the top of the parent window's client area. 
// Returns the handle to the header control. 
// hwndParent - handle to the parent window. 
// 
// Global variable 
//    g_hinst - handle to the application instance 
extern HINSTANCE g_hinst; 
//
// child-window identifier
int ID_HEADER;
//
HWND DoCreateHeader(HWND hwndParent) 
{ 
        HWND hwndHeader; 
        RECT rcParent; 
        HDLAYOUT hdl; 
        WINDOWPOS wp; 
 
        // Ensure that the common control DLL is loaded, and then create 
        // the header control. 
        INITCOMMONCONTROLSEX icex;  //declare an INITCOMMONCONTROLSEX Structure
        icex.dwSize = sizeof(INITCOMMONCONTROLSEX);
        icex.dwICC = ICC_LISTVIEW_CLASSES;   //set dwICC member to ICC_LISTVIEW_CLASSES    
                                             // this loads list-view and header control classes.
    InitCommonControlsEx(&icex); 
 
        if ((hwndHeader = CreateWindowEx(0, WC_HEADER, (LPCTSTR) NULL, 
                WS_CHILD | WS_BORDER | HDS_BUTTONS | HDS_HORZ, 
                0, 0, 0, 0, hwndParent, (HMENU) ID_HEADER, g_hinst, 
                (LPVOID) NULL)) == NULL) 
            return (HWND) NULL; 
 
        // Retrieve the bounding rectangle of the parent window's 
        // client area, and then request size and position values 
        // from the header control. 
        GetClientRect(hwndParent, &rcParent); 
 
        hdl.prc = &rcParent; 
        hdl.pwpos = ℘ 
        if (!SendMessage(hwndHeader, HDM_LAYOUT, 0, (LPARAM) &hdl)) 
            return (HWND) NULL; 
 
        // Set the size, position, and visibility of the header control. 
        SetWindowPos(hwndHeader, wp.hwndInsertAfter, wp.x, wp.y, 
            wp.cx, wp.cy, wp.flags | SWP_SHOWWINDOW); 
 
        return hwndHeader; 
}

À propos des contrôles d’en-tête

Référence du contrôle d’en-tête

Utilisation des contrôles d’en-tête