wxWidgets: wxSizerFlags Class Reference

| Version: 3.0.2

- Main Page
- Related Pages
- Categories
- Classes
- Files

- Class List
- Class Index
- Class Hierarchy
- Class Members

Public Member Functions | Static Public Member Functions | List of all members
wxSizerFlags Class Reference
Window Layout

`#include <wx/sizer.h>`

## Detailed Description

Container for sizer items flags providing readable names for them.

Normally, when you add an item to a sizer via wxSizer::Add, you have to specify a lot of flags and parameters which can be unwieldy. This is where wxSizerFlags comes in: it allows you to specify all parameters using the named methods instead. For example, instead of

sizer->Add(ctrl, 0, wxEXPAND | wxALL, 10);

you can now write

sizer->Add(ctrl, wxSizerFlags().Expand().Border(wxALL, 10));

This is more readable and also allows you to create wxSizerFlags objects which can be reused for several sizer items.

wxSizerFlags flagsExpand(1);
flagsExpand.Expand().Border(wxALL, 10);
sizer->Add(ctrl1, flagsExpand);
sizer->Add(ctrl2, flagsExpand);

Note that by specification, all methods of wxSizerFlags return the wxSizerFlags object itself to allowing chaining multiple methods calls like in the examples above.

##

Library: wxCore
Category: Window Layout

See Also
  wxSizer

## Public Member Functions
| wxSizerFlags (int proportion=0)
| Creates the wxSizer with the proportion specified by proportion.
wxSizerFlags & | Align (int alignment)
| Sets the alignment of this wxSizerFlags to align.
wxSizerFlags & | Border (int direction, int borderinpixels)
| Sets the wxSizerFlags to have a border of a number of pixels specified by borderinpixels with the directions specified by direction.
wxSizerFlags & | Border (int direction=wxALL)
| Sets the wxSizerFlags to have a border with size as returned by GetDefaultBorder().
wxSizerFlags & | Bottom ()
| Aligns the object to the bottom, similar for `Align(wxALIGN_BOTTOM)`.
wxSizerFlags & | Center ()
| Sets the object of the wxSizerFlags to center itself in the area it is given.
wxSizerFlags & | Centre ()
| Center() for people with the other dialect of English.
wxSizerFlags & | DoubleBorder (int direction=wxALL)
| Sets the border in the given direction having twice the default border size.
wxSizerFlags & | DoubleHorzBorder ()
| Sets the border in left and right directions having twice the default border size.
wxSizerFlags & | Expand ()
| Sets the object of the wxSizerFlags to expand to fill as much area as it can.
wxSizerFlags & | FixedMinSize ()
| Set the `wxFIXED_MINSIZE` flag which indicates that the initial size of the window should be also set as its minimal size.
wxSizerFlags & | ReserveSpaceEvenIfHidden ()
| Set the `wxRESERVE_SPACE_EVEN_IF_HIDDEN` flag.
wxSizerFlags & | Left ()
| Aligns the object to the left, similar for `Align(wxALIGN_LEFT)`.
wxSizerFlags & | Proportion (int proportion)
| Sets the proportion of this wxSizerFlags to proportion.
wxSizerFlags & | Right ()
| Aligns the object to the right, similar for `Align(wxALIGN_RIGHT)`.
wxSizerFlags & | Shaped ()
| Set the `wx_SHAPED` flag which indicates that the elements should always keep the fixed width to height ratio equal to its original value.
wxSizerFlags & | Top ()
| Aligns the object to the top, similar for `Align(wxALIGN_TOP)`.
wxSizerFlags & | TripleBorder (int direction=wxALL)
| Sets the border in the given direction having thrice the default border size.

## Static Public Member Functions
static int | GetDefaultBorder ()
| Returns the border used by default in Border() method.

## Constructor & Destructor Documentation

wxSizerFlags::wxSizerFlags | ( | int | proportion = `0` | ) |

Creates the wxSizer with the proportion specified by proportion.

## Member Function Documentation

wxSizerFlags& wxSizerFlags::Align | ( | int | alignment | ) |

Sets the alignment of this wxSizerFlags to align.

This method replaces the previously set alignment with the specified one.

Parameters

  alignment | Combination of `wxALIGN_XXX` bit masks.

See Also
  Top(), Left(), Right(), Bottom(), Centre()

wxSizerFlags& wxSizerFlags::Border | ( | int | direction,
|  | int | borderinpixels
| ) |  |

Sets the wxSizerFlags to have a border of a number of pixels specified by borderinpixels with the directions specified by direction.

wxSizerFlags& wxSizerFlags::Border | ( | int | direction = `wxALL` | ) |

Sets the wxSizerFlags to have a border with size as returned by GetDefaultBorder().

Parameters

  direction | Direction(s) to apply the border in.

wxSizerFlags& wxSizerFlags::Bottom | ( |  | ) |

Aligns the object to the bottom, similar for `Align(wxALIGN_BOTTOM)`.

Unlike Align(), this method doesn't change the horizontal alignment of the item.

wxSizerFlags& wxSizerFlags::Center | ( |  | ) |

Sets the object of the wxSizerFlags to center itself in the area it is given.

wxSizerFlags& wxSizerFlags::Centre | ( |  | ) |

Center() for people with the other dialect of English.

wxSizerFlags& wxSizerFlags::DoubleBorder | ( | int | direction = `wxALL` | ) |

Sets the border in the given direction having twice the default border size.

wxSizerFlags& wxSizerFlags::DoubleHorzBorder | ( |  | ) |

Sets the border in left and right directions having twice the default border size.

wxSizerFlags& wxSizerFlags::Expand | ( |  | ) |

Sets the object of the wxSizerFlags to expand to fill as much area as it can.

wxSizerFlags& wxSizerFlags::FixedMinSize | ( |  | ) |

Set the `wxFIXED_MINSIZE` flag which indicates that the initial size of the window should be also set as its minimal size.

static int wxSizerFlags::GetDefaultBorder | ( |  | ) |
| static

Returns the border used by default in Border() method.

wxSizerFlags& wxSizerFlags::Left | ( |  | ) |

Aligns the object to the left, similar for `Align(wxALIGN_LEFT)`.

Unlike Align(), this method doesn't change the vertical alignment of the item.

wxSizerFlags& wxSizerFlags::Proportion | ( | int | proportion | ) |

Sets the proportion of this wxSizerFlags to proportion.

wxSizerFlags& wxSizerFlags::ReserveSpaceEvenIfHidden | ( |  | ) |

Set the `wxRESERVE_SPACE_EVEN_IF_HIDDEN` flag.

Normally wxSizers don't allocate space for hidden windows or other items. This flag overrides this behaviour so that sufficient space is allocated for the window even if it isn't visible. This makes it possible to dynamically show and hide controls without resizing parent dialog, for example.

Since
  2.8.8

wxSizerFlags& wxSizerFlags::Right | ( |  | ) |

Aligns the object to the right, similar for `Align(wxALIGN_RIGHT)`.

Unlike Align(), this method doesn't change the vertical alignment of the item.

wxSizerFlags& wxSizerFlags::Shaped | ( |  | ) |

Set the `wx_SHAPED` flag which indicates that the elements should always keep the fixed width to height ratio equal to its original value.

wxSizerFlags& wxSizerFlags::Top | ( |  | ) |

Aligns the object to the top, similar for `Align(wxALIGN_TOP)`.

Unlike Align(), this method doesn't change the horizontal alignment of the item.

wxSizerFlags& wxSizerFlags::TripleBorder | ( | int | direction = `wxALL` | ) |

Sets the border in the given direction having thrice the default border size.