<root> / guts / Widget.hpp (4e79b469c1127c6eb2fb38c72014fc8a4747b22a) (2,610B) (mode 100644) [raw]
// 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__
Hints

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