TinyMaterialDesign
Loading...
Searching...
No Matches
SplitLayout.h
Go to the documentation of this file.
1#pragma once
2#include "TinyMaterialDesign/Core/Bounds.h"
3#include "TinyMaterialDesign/Core/LinearLayout.h"
4
5namespace tinymd {
6
7/**
8 * @brief Splits a container into two panes (master/detail, nav/content).
9 *
10 * Not a widget - see GridLayout.h for the rationale.
11 *
12 * SplitLayout split(Bounds(0, 56, 320, 400), LayoutAxis::Horizontal, 96);
13 * nav.bounds = split.firstRect();
14 * content.bounds = split.secondRect();
15 *
16 * The first pane gets `firstSize` pixels (along `axis`); the second pane
17 * gets the remainder minus the gutter. Use ratio() instead of a fixed pixel
18 * size to split proportionally (e.g. 0.3f for a 30/70 split).
19 */
21 public:
22 SplitLayout(Bounds container, LayoutAxis axis, int32_t firstSize, int32_t gutter = 8)
23 : container_(container), axis_(axis), firstSize_(firstSize), gutter_(gutter) {}
24
25 static SplitLayout ratio(Bounds container, LayoutAxis axis, float firstRatio, int32_t gutter = 8) {
26 const int32_t total = axis == LayoutAxis::Horizontal ? container.w : container.h;
27 return SplitLayout(container, axis, static_cast<int32_t>(total * firstRatio), gutter);
28 }
29
30 Bounds firstRect() const {
31 if (axis_ == LayoutAxis::Horizontal) return Bounds(container_.x, container_.y, firstSize_, container_.h);
32 return Bounds(container_.x, container_.y, container_.w, firstSize_);
33 }
34
36 const int32_t offset = firstSize_ + gutter_;
37 if (axis_ == LayoutAxis::Horizontal) {
38 return Bounds(container_.x + offset, container_.y, container_.w - offset, container_.h);
39 }
40 return Bounds(container_.x, container_.y + offset, container_.w, container_.h - offset);
41 }
42
43 private:
44 Bounds container_;
45 LayoutAxis axis_;
46 int32_t firstSize_;
47 int32_t gutter_;
48};
49
50} // namespace tinymd
Splits a container into two panes (master/detail, nav/content).
Definition: SplitLayout.h:20
SplitLayout(Bounds container, LayoutAxis axis, int32_t firstSize, int32_t gutter=8)
Definition: SplitLayout.h:22
Bounds secondRect() const
Definition: SplitLayout.h:35
static SplitLayout ratio(Bounds container, LayoutAxis axis, float firstRatio, int32_t gutter=8)
Definition: SplitLayout.h:25
Bounds firstRect() const
Definition: SplitLayout.h:30
Definition: AnchorLayout.h:4
LayoutAxis
Definition: LinearLayout.h:6
Axis-aligned pixel rectangle used for widget bounds and hit-testing.
Definition: Bounds.h:21
int32_t w
Definition: Bounds.h:24
Bounds(int32_t x, int32_t y, int32_t w, int32_t h)
Definition: Bounds.h:28
int32_t h
Definition: Bounds.h:25
int32_t y
Definition: Bounds.h:23
int32_t x
Definition: Bounds.h:22