// 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__GUTS__WIDGET_HPP__
#define LIBCURSED__GUTS__WIDGET_HPP__
namespace cursed { namespace guts {
class Pos;
class Size;
// Base class for all widgets in the library.
class Widget
{
public:
// Initializes widget with flexible size.
Widget();
protected:
// No base class destruction.
~Widget() = default;
public:
// Performs position and size update. The default just calls
// `placed(newPos, newSize)`.
virtual void place(Pos newPos, Size newSize);
// Updates state of this widget to be published on the screen.
virtual void draw() = 0;
// Sets fixed size for the widget. `desired*()` are not called for
// fixed-size widgets.
void setFixedSize(int colsNum, int linesNum);
// Retrieves vertical size policy.
// Positive number or zero means exactly that much.
// Negative number means at least that much in magnitude.
int getDesiredHeight();
// Retrieves horizontal size policy.
// Positive number or zero means exactly that much.
// Negative number means at least that much in magnitude.
int getDesiredWidth();
private:
// Retrieves vertical size policy.
// Positive number or zero means exactly that much.
// Negative number means at least that much in magnitude.
virtual int desiredHeight() = 0;
// Retrieves horizontal size policy.
// Positive number or zero means exactly that much.
// Negative number means at least that much in magnitude.
virtual int desiredWidth() = 0;
// Notifies widget of new position and size.
virtual void placed(Pos newPos, Size newSize);
private:
bool hasFixedSize; // Whether size is fixed.
int cols; // Columns for the fixed size.
int lines; // Lines for the fixed size.
};
} }
#endif // LIBCURSED__GUTS__WIDGET_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