AListView.h

/*
 * AUI Framework - Declarative UI toolkit for modern C++20
 * Copyright (C) 2020-2025 Alex2772 and Contributors
 *
 * SPDX-License-Identifier: MPL-2.0
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 */
 
#pragma once
 
#include <AUI/Model/AListModelIndex.h>
#include <AUI/Model/AListModelObserver.h>
#include <AUI/Model/AListModelSelection.h>
#include <AUI/Model/IListModel.h>
 
#include "AScrollArea.h"
 
class AListItem;
class AListViewContainer;

class API_AUI_VIEWS AListView : public AScrollArea, public AListModelObserver<AString>::IListModelListener {
   friend class AListItem;
 
public:
   enum class SelectAction {
       CLEAR_SELECTION_AND_SET,

       SET,

       UNSET,

       TOGGLE,
   };
 
   AListView() : AListView(nullptr) {}
   explicit AListView(_<IListModel<AString>> model);
   virtual ~AListView();
 
   void setModel(_<IListModel<AString>> model);
 
   void updateSelectionOnItem(size_t i, AListView::SelectAction action);

   void selectItem(size_t i) { updateSelectionOnItem(i, SelectAction::CLEAR_SELECTION_AND_SET); }
 
   int getContentFullHeight() { return getLayout()->getMinimumHeight() + 8; }
 
   void setAllowMultipleSelection(bool allowMultipleSelection);
 
   [[nodiscard]] AListModelSelection<AString> getSelectionModel() const {
       return AListModelSelection<AString>(mSelectionModel, mObserver->getModel());
   }
 
   void insertItem(size_t at, const AString& value) override;
   void updateItem(size_t at, const AString& value) override;
   void removeItem(size_t at) override;
 
   void onDataCountChanged() override;
   void onDataChanged() override;
 
signals:
   emits<AListModelSelection<AString>> selectionChanged;
   emits<unsigned> itemDoubleClicked;
 
   void clearSelection();
 
private:
   _<AListViewContainer> mContent;
   ASet<AListModelIndex> mSelectionModel;
   _<AListModelObserver<AString>> mObserver;
   bool mAllowMultipleSelection = false;
 
   void handleMousePressed(AListItem* item);
   void handleMouseDoubleClicked(AListItem* item);
 
   void clearSelectionInternal();
};

© 2025 AUI Framework Contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. All trademarks are property of their respective owners.