// libcursed -- C++ classes for dealing with curses
// Copyright (C) 2019 xaizek <xaizek@posteo.net>
//
// This file is part of libcursed.
//
// libcursed is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// libcursed is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with libcursed. If not, see <https://www.gnu.org/licenses/>.
#ifndef LIBCURSED__LIST_HPP__
#define LIBCURSED__LIST_HPP__
#include <string>
#include <vector>
#include "guts/WindowWidget.hpp"
#include "ColorTree.hpp"
#include "ListLike.hpp"
namespace cursed {
// A scrollable list of textual items.
class List : public guts::WindowWidget, public ListLike
{
public:
// Constructs an empty list. Can throw `std::runtime_error`.
explicit List();
List(const List &rhs) = delete;
List(List &&rhs) = delete;
List & operator=(const List &rhs) = delete;
List & operator=(List &&rhs) = delete;
public:
// Assigns list of items.
void setItems(std::vector<ColorTree> newItems);
// Updates an item at position (should be a valid index).
void setItem(int pos, ColorTree newValue);
// Returns value of the element under the cursor or an empty string for
// empty list.
std::wstring getCurrent() const;
// Retrieves number of elements in the list.
virtual int getSize() const override;
private:
// Updates state of this widget to be published on the screen.
virtual void draw() override;
// Retrieves vertical size policy.
// Positive number or zero means exactly that much.
// Negative number means at least that much in magnitude.
virtual int desiredHeight() override;
// Retrieves horizontal size policy.
// Positive number or zero means exactly that much.
// Negative number means at least that much in magnitude.
virtual int desiredWidth() override;
// Notifies widget of new position and size.
virtual void placed(guts::Pos newPos, guts::Size newSize) override;
// Retrieves viewport height.
virtual int getHeight() const override;
private:
std::vector<ColorTree> items; // List of items.
int height; // Screen height.
Format itemHi; // Visual style of an item.
Format currentHi; // Visual style of the current item.
};
}
#endif // LIBCURSED__LIST_HPP__
Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"
Clone this repository using HTTP(S):
git clone https://code.reversed.top/user/xaizek/libcursed
Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@code.reversed.top/user/xaizek/libcursed
You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a
pull request:
... clone the repository ...
... make some changes and some commits ...
git push origin master