InterfaceOrientationController.h

Go to the documentation of this file.

#pragma once
#include "DLLInfo.h"
#include <NDEVR/QTTools.h>
#include <NDEVR/Button.h>
#include <NDEVR/RibbonLayoutMode.h>
#include <QBoxLayout>
class QSplitter;
namespace NDEVR
{
    class PointWidget;
    class QCustomTabWidget;
    class Button;
    class InterfaceOrientationController;
    class RibbonSubGroup;
    /**--------------------------------------------------------------------------------------------------
    \brief This class is responsible for notifying and providing default layout logic when the orientation
        of the widget changes, such as for a screen rotaton.
    Espcially useful for phones that may change orientation. For example, QBoxLayouts will be set to 
        vertical when the screen is vertical and horizontal when the screen is horizontal.
    Widgets can be added inverted, meaning the opposite of the default layout behavior will occur.
    Widget will be layed out as soon as run is called on it, and subsequently when the interface layout
        changes.
    Provided widget is destroyed on the main thread, there is no need to automatically remove it from 
        the controller.
    **/
    class NDEVR_WIDGETS_API InterfaceOrientationController
    {
    public:
        InterfaceOrientationController();
        ~InterfaceOrientationController();
        bool isHorizontalMode();
        static bool isScreenHorizontal(); 
        void setHorizontal(bool is_horizontal);
        void run(QBoxLayout* l, QBoxLayout::Direction horz = QBoxLayout::LeftToRight, QBoxLayout::Direction vert = QBoxLayout::TopToBottom);
        void run(QCustomTabWidget* w, bool inverted_stack = false);
        void run(Button* w, Button::ButtonState horz = Button::ButtonState::e_push_button, Button::ButtonState vert = Button::ButtonState::e_large);
        void run(QSplitter* splitter, bool inverted_splitter = false);
        void run(PointWidget* widget, uint04 lines_horz = 2, uint04 lines_vert = 3);
        void run(Ribbon* widget, RibbonLayoutMode horz_mode = RibbonLayoutMode::e_horizontal, RibbonLayoutMode vert_mode = RibbonLayoutMode::e_vertical);
        void run(RibbonSubGroup* widget, RibbonLayoutMode horz_mode = RibbonLayoutMode::e_horizontal, RibbonLayoutMode vert_mode = RibbonLayoutMode::e_vertical);
        void remove(QObject* widget);
        static InterfaceOrientationController& Default();
    private:
        struct OrienationOption : public QObject
        {
            OrienationOption(InterfaceOrientationController* parent, QLayout* l, bool inverted_stack);
            OrienationOption(InterfaceOrientationController* parent, QWidget* w, bool inverted_stack);
            ~OrienationOption();
            QLayout* layout = nullptr;
            QWidget* widget = nullptr;
            uint04 state_horz = Constant<uint04>::Invalid;
            uint04 state_vert = Constant<uint04>::Invalid;
            bool inverted = false;
            virtual void setHorizontal(bool horizontal);
            InterfaceOrientationController* m_parent;
        };
    private:
        void addOption(OrienationOption* inter);
    private:
        Dictionary<QObject*, OrienationOption*> m_orientation_options;
        bool m_is_horizontal;
    };
}