HaikuBook: add documentation for various deprecated layout builders
The goal of this documentation is to help people that find code that uses these classes, understand that the code is outdated and to refer them to the newer template-based layout builder classes. Change-Id: I4ba632be989686749181bdbc4e7f8a29adf01a5e Reviewed-on: https://review.haiku-os.org/c/haiku/+/2353 Reviewed-by: Adrien Destugues <pulkomandy@gmail.com>
This commit is contained in:
Niels Sascha Reedijk
parent
a207d7b35b
commit
dba1e7423b
@ -1,9 +1,9 @@
|
||||
/*
|
||||
* Copyright 2019 Haiku, Inc. All rights reserved.
|
||||
* Copyright 2020 Haiku, Inc. All rights reserved.
|
||||
* Distributed under the terms of the MIT License.
|
||||
*
|
||||
* Authors:
|
||||
* Name, email@email.com
|
||||
* Niels Sascha Reedijk, niels.reedijk@gmail.com
|
||||
*
|
||||
* Corresponds to:
|
||||
* headers/os/interface/GridLayoutBuilder.h hrev38512
|
||||
@ -13,8 +13,8 @@
|
||||
|
||||
/*!
|
||||
\file GridLayoutBuilder.h
|
||||
\ingroup layout
|
||||
\brief Undocumented file.
|
||||
\ingroup libbe
|
||||
\brief Provides \b deprecated GridLayoutBuilder class.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -24,7 +24,12 @@
|
||||
\class BGridLayoutBuilder
|
||||
\ingroup layout
|
||||
\ingroup libbe
|
||||
\brief Undocumented class.
|
||||
\brief \b Deprecated helper class that helps building a \ref BGridLayout.
|
||||
|
||||
The modern builder can be found in \ref BLayoutBuilder::Grid<>.
|
||||
|
||||
\warning This class is deprecated and should not be used in new projects.
|
||||
It may be removed in newer releases.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -32,13 +37,10 @@
|
||||
|
||||
/*!
|
||||
\fn BGridLayoutBuilder::BGridLayoutBuilder(float horizontal=B_USE_DEFAULT_SPACING, float vertical=B_USE_DEFAULT_SPACING)
|
||||
\brief Undocumented public method
|
||||
\brief Create a new layout builder with a new underlying \ref BGridLayout.
|
||||
|
||||
\param horizontal Undocumented
|
||||
\param vertical Undocumented
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\param horizontal Horizontal spacing.
|
||||
\param vertical Vertical Spacing
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -46,12 +48,9 @@
|
||||
|
||||
/*!
|
||||
\fn BGridLayoutBuilder::BGridLayoutBuilder(BGridLayout *layout)
|
||||
\brief Undocumented public method
|
||||
\brief Create a new layout builder that operates on a \a layout.
|
||||
|
||||
\param layout Undocumented
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\param layout The existing layout you want the builder to alter.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -59,12 +58,9 @@
|
||||
|
||||
/*!
|
||||
\fn BGridLayoutBuilder::BGridLayoutBuilder(BGridView *view)
|
||||
\brief Undocumented public method
|
||||
\brief Create a new layout builder that operates on a \a view.
|
||||
|
||||
\param view Undocumented
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\param view The existing grid view you want the builder to alter.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -72,10 +68,9 @@
|
||||
|
||||
/*!
|
||||
\fn BGridLayout* BGridLayoutBuilder::GridLayout() const
|
||||
\brief Undocumented public method
|
||||
\brief Get a reference to the underlying \ref BGridLayout.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return A borrowed pointer to the current underlaying layout.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -83,12 +78,13 @@
|
||||
|
||||
/*!
|
||||
\fn BGridLayoutBuilder& BGridLayoutBuilder::GetGridLayout(BGridLayout **_layout)
|
||||
\brief Undocumented public method
|
||||
\brief Get a reference to the underlying \ref BGridLayout.
|
||||
|
||||
\param _layout Undocumented
|
||||
\param[out] _layout The variable to store a borrowed pointer to the
|
||||
underlying layout.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -96,10 +92,12 @@
|
||||
|
||||
/*!
|
||||
\fn BView* BGridLayoutBuilder::View() const
|
||||
\brief Undocumented public method
|
||||
\brief Get a reference to the owning \ref BView.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
Returns the same BView* as BLayout::Owner(), this method is inherited from
|
||||
BLayoutItem.
|
||||
|
||||
\return A borrowed pointer to the owning \ref BView.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -107,12 +105,13 @@
|
||||
|
||||
/*!
|
||||
\fn BGridLayoutBuilder& BGridLayoutBuilder::GetView(BView **_view)
|
||||
\brief Undocumented public method
|
||||
\brief Get a reference to the owning \ref BView.
|
||||
|
||||
\param _view Undocumented
|
||||
\param[out] _view The variable to store the borrowed pointer to the owning
|
||||
\ref BView.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -120,16 +119,16 @@
|
||||
|
||||
/*!
|
||||
\fn BGridLayoutBuilder& BGridLayoutBuilder::Add(BView *view, int32 column, int32 row, int32 columnCount=1, int32 rowCount=1)
|
||||
\brief Undocumented public method
|
||||
\brief Add a \a view to the underlying \ref BGridLayout.
|
||||
|
||||
\param view Undocumented
|
||||
\param column Undocumented
|
||||
\param row Undocumented
|
||||
\param columnCount Undocumented
|
||||
\param rowCount Undocumented
|
||||
\param view The BView to add.
|
||||
\param column The column number (zero-based) to use.
|
||||
\param row The row number (zero-based) to use.
|
||||
\param columnCount The number of columns to span over.
|
||||
\param rowCount The number of rows to span over.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -137,16 +136,16 @@
|
||||
|
||||
/*!
|
||||
\fn BGridLayoutBuilder& BGridLayoutBuilder::Add(BLayoutItem *item, int32 column, int32 row, int32 columnCount=1, int32 rowCount=1)
|
||||
\brief Undocumented public method
|
||||
\brief Add a \ref BLayoutItem to the underlying \ref BGridLayout.
|
||||
|
||||
\param item Undocumented
|
||||
\param column Undocumented
|
||||
\param row Undocumented
|
||||
\param columnCount Undocumented
|
||||
\param rowCount Undocumented
|
||||
\param item The \ref BLayoutItem to add.
|
||||
\param column The column number (zero-index) to use.
|
||||
\param row The row number (zero-index) to use.
|
||||
\param columnCount The number of columns to span over.
|
||||
\param rowCount The number of rows to span over.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -154,13 +153,13 @@
|
||||
|
||||
/*!
|
||||
\fn BGridLayoutBuilder& BGridLayoutBuilder::SetColumnWeight(int32 column, float weight)
|
||||
\brief Undocumented public method
|
||||
\brief Set the weight for \a column to \a weight.
|
||||
|
||||
\param column Undocumented
|
||||
\param weight Undocumented
|
||||
\param column The column to set.
|
||||
\param weight The weight to set.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -168,13 +167,13 @@
|
||||
|
||||
/*!
|
||||
\fn BGridLayoutBuilder& BGridLayoutBuilder::SetRowWeight(int32 row, float weight)
|
||||
\brief Undocumented public method
|
||||
\brief Set the weight of \a row to \a weight.
|
||||
|
||||
\param row Undocumented
|
||||
\param weight Undocumented
|
||||
\param row The \a row number.
|
||||
\param weight The \a weight to set.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -182,15 +181,15 @@
|
||||
|
||||
/*!
|
||||
\fn BGridLayoutBuilder& BGridLayoutBuilder::SetInsets(float left, float top, float right, float bottom)
|
||||
\brief Undocumented public method
|
||||
\brief Set the insets for the layout.
|
||||
|
||||
\param left Undocumented
|
||||
\param top Undocumented
|
||||
\param right Undocumented
|
||||
\param bottom Undocumented
|
||||
\param left The left inset as a \c float.
|
||||
\param top The top inset as a \c float.
|
||||
\param right The right inset as a \c float.
|
||||
\param bottom The bottom inset as a \c float.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -198,10 +197,9 @@
|
||||
|
||||
/*!
|
||||
\fn BGridLayoutBuilder::operator BGridLayout *()
|
||||
\brief Undocumented public method
|
||||
\brief Casts the builder to the underlying \ref BGridLayout.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
Convenience method for the \ref GridLayout() method.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
|
||||
@ -1,20 +1,21 @@
|
||||
/*
|
||||
* Copyright 2019 Haiku, Inc. All rights reserved.
|
||||
* Copyright 2020 Haiku, Inc. All rights reserved.
|
||||
* Distributed under the terms of the MIT License.
|
||||
*
|
||||
* Authors:
|
||||
* Name, email@email.com
|
||||
* Niels Sascha Reedijk, niels.reedijk@gmail.com
|
||||
*
|
||||
* Corresponds to:
|
||||
* headers/os/interface/GroupLayoutBuilder.h hrev45833
|
||||
* src/kits/<kitname>/GroupLayoutBuilder.cpp hrev38207
|
||||
* src/kits/interface/GroupLayoutBuilder.cpp hrev38207
|
||||
*/
|
||||
|
||||
|
||||
/*!
|
||||
\file GroupLayoutBuilder.h
|
||||
\ingroup layout
|
||||
\brief Undocumented file.
|
||||
\ingroup libbe
|
||||
\brief Provides \b deprecated GroupLayoutBuilder class.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -22,9 +23,16 @@
|
||||
|
||||
/*!
|
||||
\class BGroupLayoutBuilder
|
||||
\ingroup layout
|
||||
\ingroup libbe
|
||||
\brief Undocumented class.
|
||||
\brief \b Deprecated helper class that helps building a \ref BGroupLayout.
|
||||
|
||||
The modern builder can be found in \ref BLayoutBuilder::Group<>.
|
||||
|
||||
This builder supports nested group layouts. See \ref AddGroup() and
|
||||
\ref End().
|
||||
|
||||
\warning This class is deprecated and should not be used in new projects.
|
||||
It may be removed in newer releases.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -32,13 +40,10 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayoutBuilder::BGroupLayoutBuilder(orientation orientation=B_HORIZONTAL, float spacing=B_USE_DEFAULT_SPACING)
|
||||
\brief Undocumented public method
|
||||
\brief Create a new layout builder with a new underlying BGroupLayout.
|
||||
|
||||
\param orientation Undocumented
|
||||
\param spacing Undocumented
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\param orientation The orientation of the group.
|
||||
\param spacing The spacing between items.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -46,12 +51,9 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayoutBuilder::BGroupLayoutBuilder(BGroupLayout *layout)
|
||||
\brief Undocumented public method
|
||||
\brief Create a new layout builder that operates on \a layout.
|
||||
|
||||
\param layout Undocumented
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\param layout The existing layout you want the builder to alter.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -59,12 +61,9 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayoutBuilder::BGroupLayoutBuilder(BGroupView *view)
|
||||
\brief Undocumented public method
|
||||
\brief Create a new layout builder that operates on \a view.
|
||||
|
||||
\param view Undocumented
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\param view The existing group view you want the builder to alter.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -72,10 +71,9 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayout* BGroupLayoutBuilder::RootLayout() const
|
||||
\brief Undocumented public method
|
||||
\brief Get a reference to the closest underlying \ref BGroupLayout.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return A borrowed pointer to the current underlaying layout.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -83,10 +81,9 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayout* BGroupLayoutBuilder::TopLayout() const
|
||||
\brief Undocumented public method
|
||||
\brief Get a reference to the highest underlying \ref BGroupLayout.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return A borrowed pointer to the current underlaying layout.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -94,12 +91,13 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayoutBuilder& BGroupLayoutBuilder::GetTopLayout(BGroupLayout **_layout)
|
||||
\brief Undocumented public method
|
||||
\brief Get a reference to the highest underlying \ref BGroupLayout.
|
||||
|
||||
\param _layout Undocumented
|
||||
\param[out] _layout The variable to store a borrowed pointer to the
|
||||
highest underlying layout.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -107,10 +105,12 @@
|
||||
|
||||
/*!
|
||||
\fn BView* BGroupLayoutBuilder::TopView() const
|
||||
\brief Undocumented public method
|
||||
\brief Get a reference to the owning \ref BView.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
Returns the same BView* as BLayout::Owner(), this method is inherited from
|
||||
BLayoutItem.
|
||||
|
||||
\return A borrowed pointer to the owning \ref BView.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -118,12 +118,13 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayoutBuilder& BGroupLayoutBuilder::GetTopView(BView **_view)
|
||||
\brief Undocumented public method
|
||||
\brief Get a reference to the owning \ref BView.
|
||||
|
||||
\param _view Undocumented
|
||||
\param[out] _view The variable to store the borrowed pointer to the owning
|
||||
\ref BView.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -131,12 +132,12 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayoutBuilder& BGroupLayoutBuilder::Add(BView *view)
|
||||
\brief Undocumented public method
|
||||
\brief Add a \a view to the underlying \ref BGroupLayout.
|
||||
|
||||
\param view Undocumented
|
||||
\param view The BView to add.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -144,13 +145,13 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayoutBuilder& BGroupLayoutBuilder::Add(BView *view, float weight)
|
||||
\brief Undocumented public method
|
||||
\brief Add a \a view to the underlying \ref BGroupLayout.
|
||||
|
||||
\param view Undocumented
|
||||
\param weight Undocumented
|
||||
\param view The BView to add.
|
||||
\param weight The weight of this view within the group.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -158,12 +159,12 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayoutBuilder& BGroupLayoutBuilder::Add(BLayoutItem *item)
|
||||
\brief Undocumented public method
|
||||
\brief Add a \ref BLayoutItem to the underlying \ref BGroupLayout.
|
||||
|
||||
\param item Undocumented
|
||||
\param item The BLayoutItem to add.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -171,13 +172,13 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayoutBuilder& BGroupLayoutBuilder::Add(BLayoutItem *item, float weight)
|
||||
\brief Undocumented public method
|
||||
\brief Add a \ref BLayoutItem to the underlying \ref BGroupLayout.
|
||||
|
||||
\param item Undocumented
|
||||
\param weight Undocumented
|
||||
\param item The BLayoutItem to add.
|
||||
\param weight The weight of this view within the group.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -185,14 +186,15 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayoutBuilder& BGroupLayoutBuilder::AddGroup(orientation orientation, float spacing=B_USE_DEFAULT_SPACING, float weight=1.0f)
|
||||
\brief Undocumented public method
|
||||
\brief Add a subgroup to this layout, and return a reference to a builder
|
||||
that works on that subgroup.
|
||||
|
||||
\param orientation Undocumented
|
||||
\param spacing Undocumented
|
||||
\param weight Undocumented
|
||||
\param orientation The orientation of the subgroup.
|
||||
\param spacing The spacing between elements of the subgroup.
|
||||
\param weight The weight of the subgroup in the current group.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a reference to a builder that works on the newly
|
||||
added group. See \ref End().
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -200,10 +202,15 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayoutBuilder& BGroupLayoutBuilder::End()
|
||||
\brief Undocumented public method
|
||||
\brief Get a reference to a builder of the parent of the current subgroup.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
When you are currently in a subgroup, you may use this method to go back to
|
||||
the higher level layout.
|
||||
|
||||
\return The method returns a reference to a builder that works on the
|
||||
parent of the current subgroup. If you use this method on a toplevel
|
||||
group, the returned reference will be unchanged from the level that you
|
||||
are currently working on.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -211,12 +218,12 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayoutBuilder& BGroupLayoutBuilder::AddGlue(float weight=1.0f)
|
||||
\brief Undocumented public method
|
||||
\brief Set the glue for the top level group.
|
||||
|
||||
\param weight Undocumented
|
||||
\param weight The weight of the glue.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -224,12 +231,12 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayoutBuilder& BGroupLayoutBuilder::AddStrut(float size)
|
||||
\brief Undocumented public method
|
||||
\brief Add a strut to the current group.
|
||||
|
||||
\param size Undocumented
|
||||
\param size The size of the strut.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -237,15 +244,15 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayoutBuilder& BGroupLayoutBuilder::SetInsets(float left, float top, float right, float bottom)
|
||||
\brief Undocumented public method
|
||||
\brief Set the insets of the top level group.
|
||||
|
||||
\param left Undocumented
|
||||
\param top Undocumented
|
||||
\param right Undocumented
|
||||
\param bottom Undocumented
|
||||
\param left The left inset.
|
||||
\param top The top inset.
|
||||
\param right The right inset.
|
||||
\param bottom The bottom inset.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -253,10 +260,9 @@
|
||||
|
||||
/*!
|
||||
\fn BGroupLayoutBuilder::operator BGroupLayout *()
|
||||
\brief Undocumented public method
|
||||
\brief Cast the builder to the underlying \ref BGroupLayout.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
Convenience method for the \ref RootLayout() method.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
|
||||
@ -1,9 +1,9 @@
|
||||
/*
|
||||
* Copyright 2019 Haiku, Inc. All rights reserved.
|
||||
* Copyright 2020 Haiku, Inc. All rights reserved.
|
||||
* Distributed under the terms of the MIT License.
|
||||
*
|
||||
* Authors:
|
||||
* Name, email@email.com
|
||||
* Niels Sascha Reedijk, niels.reedijk@gmail.com
|
||||
*
|
||||
* Corresponds to:
|
||||
* headers/os/interface/SplitLayoutBuilder.h hrev45833
|
||||
@ -14,7 +14,8 @@
|
||||
/*!
|
||||
\file SplitLayoutBuilder.h
|
||||
\ingroup layout
|
||||
\brief Undocumented file.
|
||||
\ingroup libbe
|
||||
\brief Provides \b deprecated SplitLayoutBuilder class.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -22,9 +23,13 @@
|
||||
|
||||
/*!
|
||||
\class BSplitLayoutBuilder
|
||||
\ingroup layout
|
||||
\ingroup libbe
|
||||
\brief Undocumented class.
|
||||
\brief \b Deprecated helper class that helps building a \ref BSplitView.
|
||||
|
||||
The modern builder can be found in \ref BLayoutBuilder::Split<>.
|
||||
|
||||
\warning This class is deprecated and should not be used in new projects.
|
||||
It may be removed in newer releases.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -32,13 +37,10 @@
|
||||
|
||||
/*!
|
||||
\fn BSplitLayoutBuilder::BSplitLayoutBuilder(orientation orientation=B_HORIZONTAL, float spacing=B_USE_DEFAULT_SPACING)
|
||||
\brief Undocumented public method
|
||||
\brief Create a new layout builder with an underlying \ref BSplitView.
|
||||
|
||||
\param orientation Undocumented
|
||||
\param spacing Undocumented
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\param orientation The orientation of the split view.
|
||||
\param spacing The spacing of items within the split view.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -46,12 +48,9 @@
|
||||
|
||||
/*!
|
||||
\fn BSplitLayoutBuilder::BSplitLayoutBuilder(BSplitView *view)
|
||||
\brief Undocumented public method
|
||||
\brief Create a new layout builder that operates on an existing \a view.
|
||||
|
||||
\param view Undocumented
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\param view The existing view you want the builder to alter.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -59,10 +58,9 @@
|
||||
|
||||
/*!
|
||||
\fn BSplitView* BSplitLayoutBuilder::SplitView() const
|
||||
\brief Undocumented public method
|
||||
\brief Get a reference to the underlying \ref BSplitView.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return A borrowed pointer to the current underlaying view.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -70,12 +68,13 @@
|
||||
|
||||
/*!
|
||||
\fn BSplitLayoutBuilder& BSplitLayoutBuilder::GetSplitView(BSplitView **view)
|
||||
\brief Undocumented public method
|
||||
\brief Get a reference to the underlying \ref BSplitView.
|
||||
|
||||
\param view Undocumented
|
||||
\param[out] view The variable to store a borrowed pointer to the
|
||||
underlying view.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -83,12 +82,12 @@
|
||||
|
||||
/*!
|
||||
\fn BSplitLayoutBuilder& BSplitLayoutBuilder::Add(BView *view)
|
||||
\brief Undocumented public method
|
||||
\brief Add a \a view to the underlying \ref BSplitView.
|
||||
|
||||
\param view Undocumented
|
||||
\param view The \ref BView to add.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -96,13 +95,13 @@
|
||||
|
||||
/*!
|
||||
\fn BSplitLayoutBuilder& BSplitLayoutBuilder::Add(BView *view, float weight)
|
||||
\brief Undocumented public method
|
||||
\brief Add a \a view to the underlying \ref BSplitView.
|
||||
|
||||
\param view Undocumented
|
||||
\param weight Undocumented
|
||||
\param view The \ref BView to add.
|
||||
\param weight The weight of the item.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -110,12 +109,12 @@
|
||||
|
||||
/*!
|
||||
\fn BSplitLayoutBuilder& BSplitLayoutBuilder::Add(BLayoutItem *item)
|
||||
\brief Undocumented public method
|
||||
\brief Add a \ref BLayoutItem to the underlying \ref BSplitView.
|
||||
|
||||
\param item Undocumented
|
||||
\param item The \ref BLayoutItem to add.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -123,13 +122,13 @@
|
||||
|
||||
/*!
|
||||
\fn BSplitLayoutBuilder& BSplitLayoutBuilder::Add(BLayoutItem *item, float weight)
|
||||
\brief Undocumented public method
|
||||
\brief Add a \ref BLayoutItem to the underlying \ref BSplitView.
|
||||
|
||||
\param item Undocumented
|
||||
\param weight Undocumented
|
||||
\param item The \ref BLayoutItem to add.
|
||||
\param weight The weight of the \a item.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -137,12 +136,12 @@
|
||||
|
||||
/*!
|
||||
\fn BSplitLayoutBuilder& BSplitLayoutBuilder::SetCollapsible(bool collapsible)
|
||||
\brief Undocumented public method
|
||||
\brief Set the collapsability of the most recently added item.
|
||||
|
||||
\param collapsible Undocumented
|
||||
\param collapsible \c true if the item is collapsible, \c false otherwise.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -150,15 +149,15 @@
|
||||
|
||||
/*!
|
||||
\fn BSplitLayoutBuilder& BSplitLayoutBuilder::SetInsets(float left, float top, float right, float bottom)
|
||||
\brief Undocumented public method
|
||||
\brief Set the insets of the underlying \ref BSplitView.
|
||||
|
||||
\param left Undocumented
|
||||
\param top Undocumented
|
||||
\param right Undocumented
|
||||
\param bottom Undocumented
|
||||
\param left The left inset.
|
||||
\param top The top inset.
|
||||
\param right The right inset.
|
||||
\param bottom The bottom inset.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
\return The method returns a self reference, so that calls to the builder
|
||||
may be chained.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
@ -166,10 +165,9 @@
|
||||
|
||||
/*!
|
||||
\fn BSplitLayoutBuilder::operator BSplitView *()
|
||||
\brief Undocumented public method
|
||||
\brief Cast the builder to the underlying \ref BSplitView.
|
||||
|
||||
\return Undocumented
|
||||
\retval <value> Undocumented
|
||||
Convenience method for the \ref SplitView() method.
|
||||
|
||||
\since Haiku R1
|
||||
*/
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user