2008-02-25 04:54:05 +03:00
|
|
|
/*
|
2010-09-22 03:31:50 +04:00
|
|
|
* Copyright 2006 - 2010, Haiku, Inc. All rights reserved.
|
2008-02-25 04:54:05 +03:00
|
|
|
* Distributed under the terms of the MIT License.
|
|
|
|
*/
|
2010-09-22 03:31:50 +04:00
|
|
|
#ifndef ALM_LAYOUT_H
|
|
|
|
#define ALM_LAYOUT_H
|
2008-02-06 13:51:44 +03:00
|
|
|
|
2010-09-23 01:53:32 +04:00
|
|
|
|
2010-08-17 22:43:41 +04:00
|
|
|
#include <AbstractLayout.h>
|
2008-02-06 13:51:44 +03:00
|
|
|
#include <File.h>
|
|
|
|
#include <List.h>
|
|
|
|
#include <Size.h>
|
|
|
|
#include <SupportDefs.h>
|
|
|
|
#include <View.h>
|
|
|
|
|
2009-10-28 12:00:14 +03:00
|
|
|
#include "Area.h"
|
|
|
|
#include "Column.h"
|
2008-02-06 13:51:44 +03:00
|
|
|
#include "LinearSpec.h"
|
2010-09-20 10:26:32 +04:00
|
|
|
#include "Row.h"
|
2010-09-30 05:32:48 +04:00
|
|
|
#include "Tab.h"
|
2008-02-06 13:51:44 +03:00
|
|
|
|
|
|
|
|
|
|
|
namespace BALM {
|
2010-09-23 04:04:08 +04:00
|
|
|
|
2011-03-14 03:24:12 +03:00
|
|
|
|
|
|
|
class RowColumnManager;
|
|
|
|
|
|
|
|
|
2010-09-23 01:53:32 +04:00
|
|
|
/*!
|
|
|
|
* A GUI layout engine using the Auckland Layout Model (ALM).
|
2008-02-06 13:51:44 +03:00
|
|
|
*/
|
2010-09-21 02:47:13 +04:00
|
|
|
class BALMLayout : public BAbstractLayout {
|
2008-02-06 13:51:44 +03:00
|
|
|
public:
|
2012-01-16 02:54:25 +04:00
|
|
|
BALMLayout(float hSpacing = 0.0f,
|
|
|
|
float vSpacing = 0.0f,
|
2010-10-21 15:19:18 +04:00
|
|
|
BALMLayout* friendLayout = NULL);
|
2010-09-21 11:04:40 +04:00
|
|
|
virtual ~BALMLayout();
|
|
|
|
|
2011-11-30 08:55:36 +04:00
|
|
|
BReference<XTab> AddXTab();
|
2012-01-17 01:37:12 +04:00
|
|
|
void AddXTabs(BReference<XTab>* tabs, uint32 count);
|
2011-11-30 08:55:36 +04:00
|
|
|
BReference<YTab> AddYTab();
|
2012-01-17 01:37:12 +04:00
|
|
|
void AddYTabs(BReference<YTab>* tabs, uint32 count);
|
2011-11-30 08:55:36 +04:00
|
|
|
|
2011-03-14 03:24:12 +03:00
|
|
|
int32 CountXTabs() const;
|
|
|
|
int32 CountYTabs() const;
|
|
|
|
XTab* XTabAt(int32 index) const;
|
|
|
|
YTab* YTabAt(int32 index) const;
|
2011-11-30 08:55:36 +04:00
|
|
|
/*! Order the tab list and return a reference to the list. */
|
|
|
|
const XTabList& OrderedXTabs();
|
|
|
|
const YTabList& OrderedYTabs();
|
2011-03-14 03:24:12 +03:00
|
|
|
|
2010-09-20 10:26:32 +04:00
|
|
|
Row* AddRow(YTab* top, YTab* bottom);
|
|
|
|
Column* AddColumn(XTab* left, XTab* right);
|
2010-09-23 01:53:32 +04:00
|
|
|
|
2010-09-20 10:26:32 +04:00
|
|
|
XTab* Left() const;
|
|
|
|
XTab* Right() const;
|
|
|
|
YTab* Top() const;
|
|
|
|
YTab* Bottom() const;
|
2008-02-06 13:51:44 +03:00
|
|
|
|
2010-09-29 07:30:47 +04:00
|
|
|
LinearSpec* Solver() const;
|
2010-09-21 02:47:13 +04:00
|
|
|
|
2012-01-16 02:54:25 +04:00
|
|
|
void SetInsets(float insets);
|
|
|
|
void SetInsets(float x, float y);
|
|
|
|
void SetInsets(float left, float top, float right,
|
|
|
|
float bottom);
|
|
|
|
void GetInsets(float* left, float* top, float* right,
|
|
|
|
float* bottom) const;
|
2010-09-23 04:53:33 +04:00
|
|
|
|
2012-01-16 02:54:25 +04:00
|
|
|
void SetSpacing(float hSpacing, float vSpacing);
|
|
|
|
void GetSpacing(float* _hSpacing,
|
|
|
|
float* _vSpacing) const;
|
2010-09-29 07:30:47 +04:00
|
|
|
|
2012-01-11 08:19:29 +04:00
|
|
|
Area* AreaFor(int32 id) const;
|
2010-09-30 05:32:48 +04:00
|
|
|
Area* AreaFor(const BView* view) const;
|
2010-09-29 07:30:47 +04:00
|
|
|
Area* AreaFor(const BLayoutItem* item) const;
|
2012-01-10 08:43:58 +04:00
|
|
|
int32 CountAreas() const;
|
2011-03-14 03:24:12 +03:00
|
|
|
Area* AreaAt(int32 index) const;
|
2010-09-29 07:30:47 +04:00
|
|
|
|
2010-09-30 05:32:48 +04:00
|
|
|
XTab* LeftOf(const BView* view) const;
|
|
|
|
XTab* LeftOf(const BLayoutItem* item) const;
|
|
|
|
XTab* RightOf(const BView* view) const;
|
|
|
|
XTab* RightOf(const BLayoutItem* item) const;
|
|
|
|
YTab* TopOf(const BView* view) const;
|
|
|
|
YTab* TopOf(const BLayoutItem* item) const;
|
|
|
|
YTab* BottomOf(const BView* view) const;
|
|
|
|
YTab* BottomOf(const BLayoutItem* item) const;
|
|
|
|
|
2010-10-04 00:05:52 +04:00
|
|
|
void BuildLayout(GroupItem& item, XTab* left = NULL,
|
|
|
|
YTab* top = NULL, XTab* right = NULL,
|
|
|
|
YTab* bottom = NULL);
|
|
|
|
|
2010-09-23 11:16:49 +04:00
|
|
|
virtual BLayoutItem* AddView(BView* child);
|
|
|
|
virtual BLayoutItem* AddView(int32 index, BView* child);
|
|
|
|
virtual Area* AddView(BView* view, XTab* left, YTab* top,
|
2010-09-30 05:32:48 +04:00
|
|
|
XTab* right = NULL, YTab* bottom = NULL);
|
2010-09-23 11:16:49 +04:00
|
|
|
virtual Area* AddView(BView* view, Row* row, Column* column);
|
|
|
|
|
|
|
|
virtual bool AddItem(BLayoutItem* item);
|
|
|
|
virtual bool AddItem(int32 index, BLayoutItem* item);
|
|
|
|
virtual Area* AddItem(BLayoutItem* item, XTab* left,
|
2010-09-30 05:32:48 +04:00
|
|
|
YTab* top, XTab* right = NULL,
|
|
|
|
YTab* bottom = NULL);
|
2010-09-23 11:16:49 +04:00
|
|
|
virtual Area* AddItem(BLayoutItem* item, Row* row,
|
|
|
|
Column* column);
|
2011-11-30 08:55:36 +04:00
|
|
|
|
2012-01-10 08:43:58 +04:00
|
|
|
bool SaveLayout(BMessage* archive) const;
|
|
|
|
bool RestoreLayout(const BMessage* archive);
|
|
|
|
|
2010-09-23 11:16:49 +04:00
|
|
|
virtual BSize BaseMinSize();
|
|
|
|
virtual BSize BaseMaxSize();
|
|
|
|
virtual BSize BasePreferredSize();
|
|
|
|
virtual BAlignment BaseAlignment();
|
|
|
|
|
2011-10-23 00:54:43 +04:00
|
|
|
protected:
|
2010-09-23 11:16:49 +04:00
|
|
|
virtual bool ItemAdded(BLayoutItem* item, int32 atIndex);
|
|
|
|
virtual void ItemRemoved(BLayoutItem* item, int32 fromIndex);
|
2011-10-23 00:54:43 +04:00
|
|
|
|
|
|
|
virtual void LayoutInvalidated(bool children);
|
|
|
|
virtual void DoLayout();
|
2010-09-23 11:16:49 +04:00
|
|
|
|
2008-02-06 13:51:44 +03:00
|
|
|
private:
|
2011-11-30 08:55:36 +04:00
|
|
|
friend class XTab;
|
|
|
|
friend class YTab;
|
2012-01-16 02:54:25 +04:00
|
|
|
friend class Area;
|
|
|
|
|
|
|
|
float InsetForTab(XTab* tab);
|
|
|
|
float InsetForTab(YTab* tab);
|
2011-11-30 08:55:36 +04:00
|
|
|
|
2012-01-16 03:36:51 +04:00
|
|
|
BLayoutItem* _LayoutItemToAdd(BView* view);
|
2010-09-23 11:16:49 +04:00
|
|
|
|
2010-09-22 03:18:43 +04:00
|
|
|
void _UpdateAreaConstraints();
|
2010-09-21 11:04:40 +04:00
|
|
|
|
2010-09-22 09:29:50 +04:00
|
|
|
BSize _CalculateMinSize();
|
|
|
|
BSize _CalculateMaxSize();
|
|
|
|
BSize _CalculatePreferredSize();
|
2008-02-06 13:51:44 +03:00
|
|
|
|
2011-11-30 08:55:36 +04:00
|
|
|
void _ParseGroupItem(GroupItem& item,
|
|
|
|
BReference<XTab> left, BReference<YTab> top,
|
|
|
|
BReference<XTab> right,
|
|
|
|
BReference<YTab> bottom);
|
2008-02-06 13:51:44 +03:00
|
|
|
|
2010-10-21 15:19:18 +04:00
|
|
|
LinearSpec* fSolver;
|
|
|
|
LinearSpec fOwnSolver;
|
2010-09-21 02:47:13 +04:00
|
|
|
|
2011-11-30 08:55:36 +04:00
|
|
|
BReference<XTab> fLeft;
|
|
|
|
BReference<XTab> fRight;
|
|
|
|
BReference<YTab> fTop;
|
|
|
|
BReference<YTab> fBottom;
|
2010-09-20 10:26:32 +04:00
|
|
|
BSize fMinSize;
|
|
|
|
BSize fMaxSize;
|
|
|
|
BSize fPreferredSize;
|
2010-09-23 04:53:33 +04:00
|
|
|
|
2012-01-16 02:54:25 +04:00
|
|
|
float fLeftInset;
|
|
|
|
float fRightInset;
|
|
|
|
float fTopInset;
|
|
|
|
float fBottomInset;
|
|
|
|
|
|
|
|
float fHSpacing;
|
|
|
|
float fVSpacing;
|
2010-09-29 07:30:47 +04:00
|
|
|
|
2011-03-14 03:24:12 +03:00
|
|
|
XTabList fXTabList;
|
|
|
|
YTabList fYTabList;
|
|
|
|
|
|
|
|
RowColumnManager* fRowColumnManager;
|
2008-02-06 13:51:44 +03:00
|
|
|
};
|
|
|
|
|
|
|
|
} // namespace BALM
|
|
|
|
|
2012-01-17 01:37:12 +04:00
|
|
|
|
2008-02-06 13:51:44 +03:00
|
|
|
using BALM::BALMLayout;
|
|
|
|
|
2012-01-17 01:37:12 +04:00
|
|
|
|
2010-09-22 03:31:50 +04:00
|
|
|
#endif // ALM_LAYOUT_H
|