xref: /haiku/docs/user/interface/layout_tips.dox (revision 25a7b01d15612846f332751841da3579db313082)
1/*!
2	\page layout_tips
3
4	\section layout_window_tips BWindow Tips
5
6	\li You can use the BLayoutBuilder classes to build a layout directly into
7		a BWindow.
8	\li Passing the B_AUTO_UPDATE_SIZE_LIMITS flag to a BWindow with a BLayout
9		will make sure that window is always big enough to accomadate everything
10		in it.
11
12	\section layout_view_tips BView Tips
13
14	\li When the main purpose of a BView is to hold a BLayout, consider nesting
15		the BLayout directly (i.e. without a BView)
16
17	\li When the main purpose of a BView is to hold another BView which has
18		children added to it, consider adding directly to the first BView.
19
20	\li When the main purpose of a BView is to hold a BLayout, but you also wish
21		to have a view color set for that area, considering using one of the
22		layout-related convenience classes (eg. BGroupView for BGroupLayout).
23
24	\li When the main purpose of a BView is to hold a BLayout, but it must be
25		populated before being attached to another BView or a BWindow,
26		consider using one of the layout-related convenience classes (eg.
27		BGroupView for BGroupLayout).
28
29	\section layout_layout_tips BLayout Tips
30
31	\li It is generally better to add BViews and BLayoutItems directly to the
32		BLayout subclass attached to a BView, rather than the BView itself. This
33		way, you can make full use of the specific features the subclass you're
34		using provides.
35*/
36