Поделиться через


Создание элемента управления list-View

В этом разделе показано, как создать элемент управления представлением списка. Чтобы создать элемент управления представлением списка, используйте функцию CreateWindow или CreateWindowEx и укажите класс окна WC_LISTVIEW.

Элемент управления представлением списка также можно создать как часть шаблона диалогового окна. Необходимо указать WC_LISTVIEW в качестве имени класса. Чтобы использовать элемент управления представлением списка в рамках шаблона диалогового окна, необходимо вызвать InitCommonControls или InitCommonControlsEx перед созданием экземпляра диалогового окна.

Это важно знать

Технологии

Необходимые компоненты

  • C/C++
  • Программирование пользовательского интерфейса Windows

Instructions

Сначала зарегистрируйте класс окна, вызвав функцию InitCommonControlsEx и указав ICC_LISTVIEW_CLASSES бит в сопутствующей структуре INITCOMMONCONTROLSEX. Это гарантирует загрузку библиотеки DLL общих элементов управления. Затем используйте функцию CreateWindow или CreateWindowEx и укажите класс окна WC_LISTVIEW.

Примечание.

По умолчанию элемент управления представления списка использует шрифт заголовка значка. Однако можно использовать сообщение WM_SETFONT для указания шрифта, который будет использоваться для текста. Перед вставой элементов необходимо отправить это сообщение. Элемент управления использует измерения шрифта, указанного сообщением WM_SETFONT для определения интервалов и макета. Вы также можете настроить шрифт для каждого элемента. Дополнительные сведения см. в разделе "Настраиваемое рисование".

 

В следующем примере кода C++ создается элемент управления представлением списка в представлении отчета.

// CreateListView: Creates a list-view control in report view.
// Returns the handle to the new control
// TO DO:  The calling procedure should determine whether the handle is NULL, in case 
// of an error in creation.
//
// HINST hInst: The global handle to the application instance.
// HWND  hWndParent: The handle to the control's parent window. 
//
HWND CreateListView (HWND hwndParent) 
{
    INITCOMMONCONTROLSEX icex;           // Structure for control initialization.
    icex.dwICC = ICC_LISTVIEW_CLASSES;
    InitCommonControlsEx(&icex);

    RECT rcClient;                       // The parent window's client area.

    GetClientRect (hwndParent, &rcClient); 

    // Create the list-view window in report view with label editing enabled.
    HWND hWndListView = CreateWindow(WC_LISTVIEW, 
                                     L"",
                                     WS_CHILD | LVS_REPORT | LVS_EDITLABELS,
                                     0, 0,
                                     rcClient.right - rcClient.left,
                                     rcClient.bottom - rcClient.top,
                                     hwndParent,
                                     (HMENU)IDM_CODE_SAMPLES,
                                     g_hInst,
                                     NULL); 

    return (hWndListView);
}

Как правило, приложения представления списка позволяют пользователю изменяться с одного представления на другое.

В следующем примере кода C++ изменяется стиль окна представления списка, который, в свою очередь, изменяет представление.

// SetView: Sets a list-view's window style to change the view.
// hWndListView: A handle to the list-view control. 
// dwView:       A value specifying the new view style.
//
VOID SetView(HWND hWndListView, DWORD dwView) 
{ 
    // Retrieve the current window style. 
    DWORD dwStyle = GetWindowLong(hWndListView, GWL_STYLE); 
    
    // Set the window style only if the view bits changed.
    if ((dwStyle & LVS_TYPEMASK) != dwView) 
    {
        SetWindowLong(hWndListView,
                      GWL_STYLE,
                      (dwStyle & ~LVS_TYPEMASK) | dwView);
    }               // Logical OR'ing of dwView with the result of 
}                   // a bitwise AND between dwStyle and 
                    // the Unary complement of LVS_TYPEMASK.

Справочник по элементу управления List-View

Сведения о элементах управления "Представление списка"

Использование элементов управления "Представление списка"