//---------------------------------------------------------------------------
%newgroup;
+DocStr(wxGBPosition,
+"This class represents the position of an item in a virtual grid of
+rows and columns managed by a `wx.GridBagSizer`. wxPython has
+typemaps that will automatically convert from a 2-element sequence of
+integers to a wx.GBPosition, so you can use the more pythonic
+representation of the position nearly transparently in Python code.", "");
class wxGBPosition
{
+DocStr(wxGBSpan,
+"This class is used to hold the row and column spanning attributes of
+items in a `wx.GridBagSizer`. wxPython has typemaps that will
+automatically convert from a 2-element sequence of integers to a
+wx.GBSpan, so you can use the more pythonic representation of the span
+nearly transparently in Python code.
+", "");
+
class wxGBSpan
{
public:
- wxGBSpan(int rowspan=1, int colspan=1);
+ DocCtorStr(
+ wxGBSpan(int rowspan=1, int colspan=1),
+ "Construct a new wxGBSpan, optionally setting the rowspan and
+colspan. The default is (1,1). (Meaning that the item occupies one
+cell in each direction.", "");
int GetRowspan() const;
int GetColspan() const;
//---------------------------------------------------------------------------
+DocStr(wxGBSizerItem,
+"The wx.GBSizerItem class is used to track the additional data about
+items in a `wx.GridBagSizer` such as the item's position in the grid
+and how many rows or columns it spans.
+", "");
class wxGBSizerItem : public wxSizerItem
{
public:
- wxGBSizerItem();
-
- %name(GBSizerItemWindow) wxGBSizerItem( wxWindow *window,
- const wxGBPosition& pos,
- const wxGBSpan& span,
- int flag,
- int border,
- wxObject* userData );
-
- %name(GBSizerItemSizer) wxGBSizerItem( wxSizer *sizer,
- const wxGBPosition& pos,
- const wxGBSpan& span,
- int flag,
- int border,
- wxObject* userData );
-
- %name(GBSizerItemSpacer) wxGBSizerItem( int width,
- int height,
- const wxGBPosition& pos,
- const wxGBSpan& span,
- int flag,
- int border,
- wxObject* userData);
-
-
- // Get the grid position of the item
- wxGBPosition GetPos() const;
+ DocCtorStr(
+ wxGBSizerItem(),
+ "Constructs an empty wx.GBSizerItem. Either a window, sizer or spacer
+size will need to be set, as well as a position and span before this
+item can be used in a Sizer.
+
+You will probably never need to create a wx.GBSizerItem directly as they
+are created automatically when the sizer's Add method is called.", "");
+
+ %extend {
+ DocStr(wxGBSizerItem( wxWindow *window, const wxGBPosition& pos,const wxGBSpan& span,int flag,int border,PyObject* userData=NULL ),
+ "Construct a `wx.GBSizerItem` for a window.", "");
+ %name(GBSizerItemWindow) wxGBSizerItem( wxWindow *window,
+ const wxGBPosition& pos,
+ const wxGBSpan& span,
+ int flag,
+ int border,
+ PyObject* userData=NULL )
+ {
+ wxPyUserData* data = NULL;
+ if ( userData ) {
+ bool blocked = wxPyBeginBlockThreads();
+ data = new wxPyUserData(userData);
+ wxPyEndBlockThreads(blocked);
+ }
+ return new wxGBSizerItem(window, pos, span, flag, border, data);
+ }
+
+
+ DocStr(wxGBSizerItem( wxSizer *sizer,const wxGBPosition& pos,const wxGBSpan& span,int flag,int border,PyObject* userData=NULL ),
+ "Construct a `wx.GBSizerItem` for a sizer", "");
+ %name(GBSizerItemSizer) wxGBSizerItem( wxSizer *sizer,
+ const wxGBPosition& pos,
+ const wxGBSpan& span,
+ int flag,
+ int border,
+ PyObject* userData=NULL )
+ {
+ wxPyUserData* data = NULL;
+ if ( userData ) {
+ bool blocked = wxPyBeginBlockThreads();
+ data = new wxPyUserData(userData);
+ wxPyEndBlockThreads(blocked);
+ }
+ return new wxGBSizerItem(sizer, pos, span, flag, border, data);
+ }
+
+
+ DocStr(wxGBSizerItem( int width,int height,const wxGBPosition& pos,const wxGBSpan& span,int flag,int border,PyObject* userData=NULL),
+ "Construct a `wx.GBSizerItem` for a spacer.", "");
+ %name(GBSizerItemSpacer) wxGBSizerItem( int width,
+ int height,
+ const wxGBPosition& pos,
+ const wxGBSpan& span,
+ int flag,
+ int border,
+ PyObject* userData=NULL)
+ {
+ wxPyUserData* data = NULL;
+ if ( userData ) {
+ bool blocked = wxPyBeginBlockThreads();
+ data = new wxPyUserData(userData);
+ wxPyEndBlockThreads(blocked);
+ }
+ return new wxGBSizerItem(width, height, pos, span, flag, border, data);
+ }
+ }
+
+
+ DocDeclStr(
+ wxGBPosition , GetPos() const,
+ "Get the grid position of the item", "");
+
%pythoncode { def GetPosTuple(self): return self.GetPos().Get() }
- // Get the row and column spanning of the item
- wxGBSpan GetSpan() const;
+
+
+ DocDeclStr(
+ wxGBSpan , GetSpan() const,
+ "Get the row and column spanning of the item", "");
+
%pythoncode { def GetSpanTuple(self): return self.GetSpan().Get() }
- // If the item is already a member of a sizer then first ensure that there
- // is no other item that would intersect with this one at the new
- // position, then set the new position. Returns True if the change is
- // successful and after the next Layout the item will be moved.
- bool SetPos( const wxGBPosition& pos );
-
- // If the item is already a member of a sizer then first ensure that there
- // is no other item that would intersect with this one with its new
- // spanning size, then set the new spanning. Returns True if the change
- // is successful and after the next Layout the item will be resized.
- bool SetSpan( const wxGBSpan& span );
+
+
+ DocDeclStr(
+ bool , SetPos( const wxGBPosition& pos ),
+ "If the item is already a member of a sizer then first ensure that
+there is no other item that would intersect with this one at the new
+position, then set the new position. Returns True if the change is
+successful and after the next Layout() the item will be moved.", "");
+
- %nokwargs Intersects;
+ DocDeclStr(
+ bool , SetSpan( const wxGBSpan& span ),
+ "If the item is already a member of a sizer then first ensure that
+there is no other item that would intersect with this one with its new
+spanning size, then set the new spanning. Returns True if the change
+is successful and after the next Layout() the item will be resized.
+", "");
- // Returns True if this item and the other item instersect
- bool Intersects(const wxGBSizerItem& other);
- // Returns True if the given pos/span would intersect with this item.
- bool Intersects(const wxGBPosition& pos, const wxGBSpan& span);
+
+ DocDeclStr(
+ bool , Intersects(const wxGBSizerItem& other),
+ "Returns True if this item and the other item instersect.", "");
+
- // Get the row and column of the endpoint of this item
- void GetEndPos(int& row, int& col);
+ DocDeclStrName(
+ bool , Intersects(const wxGBPosition& pos, const wxGBSpan& span),
+ "Returns True if the given pos/span would intersect with this item.", "",
+ IntersectsPos);
+
+ %extend {
+ DocStr(GetEndPos,
+ "Get the row and column of the endpoint of this item.", "");
+ wxGBPosition GetEndPos() {
+ int row, col;
+ self->GetEndPos(row, col);
+ return wxGBPosition(row, col);
+ }
+ }
- wxGridBagSizer* GetGBSizer() const;
- void SetGBSizer(wxGridBagSizer* sizer);
+
+ DocDeclStr(
+ wxGridBagSizer* , GetGBSizer() const,
+ "Get the sizer this item is a member of.", "");
+
+ DocDeclStr(
+ void , SetGBSizer(wxGridBagSizer* sizer),
+ "Set the sizer this item is a member of.", "");
};
//---------------------------------------------------------------------------
+DocStr(wxGridBagSizer,
+"A `wx.Sizer` that can lay out items in a virtual grid like a
+`wx.FlexGridSizer` but in this case explicit positioning of the items
+is allowed using `wx.GBPosition`, and items can optionally span more
+than one row and/or column using `wx.GBSpan`. The total size of the
+virtual grid is determined by the largest row and column that items are
+positioned at, adjusted for spanning.
+", "");
class wxGridBagSizer : public wxFlexGridSizer
{
public:
- wxGridBagSizer(int vgap = 0, int hgap = 0 );
+ DocCtorStr(
+ wxGridBagSizer(int vgap = 0, int hgap = 0 ),
+ "Constructor, with optional parameters to specify the gap between the
+rows and columns.", "");
- // The Add method returns True if the item was successfully placed at the
- // given cell position, False if something was already there.
+
%extend {
+ DocAStr(Add,
+ "Add(self, item, GBPosition pos, GBSpan span=DefaultSpan, int flag=0,
+int border=0, userData=None)",
+
+ "Adds an item to the sizer at the grid cell *pos*, optionally spanning
+more than one row or column as specified with *span*. The remaining
+args behave similarly to `wx.Sizer.Add`.
+
+Returns True if the item was successfully placed at the given cell
+position, False if something was already there.
+", "");
bool Add( PyObject* item,
const wxGBPosition& pos,
const wxGBSpan& span = wxDefaultSpan,
}
}
- %name(AddItem) bool Add( wxGBSizerItem *item );
-
+ DocDeclAStrName(
+ bool , Add( wxGBSizerItem *item ),
+ "Add(self, GBSizerItem item) -> bool",
+ "Add an item to the sizer using a `wx.GBSizerItem`. Returns True if
+the item was successfully placed at its given cell position, False if
+something was already there.", "",
+ AddItem);
+
- // Get/Set the size used for cells in the grid with no item.
- wxSize GetEmptyCellSize() const;
- void SetEmptyCellSize(const wxSize& sz);
+ DocDeclStr(
+ wxSize , GetEmptyCellSize() const,
+ "Get the size used for cells in the grid with no item.", "");
+
+ DocDeclStr(
+ void , SetEmptyCellSize(const wxSize& sz),
+ "Set the size used for cells in the grid with no item.", "");
+
- // Get the grid position of the specified item
+
%nokwargs GetItemPosition;
+ %noautodoc GetItemPosition;
+ DocStr(GetItemPosition,
+ "GetItemPosition(self, item) -> GBPosition
+
+Get the grid position of the specified *item* where *item* is either a
+window or subsizer that is a member of this sizer, or a zero-based
+index of an item.", "");
wxGBPosition GetItemPosition(wxWindow *window);
wxGBPosition GetItemPosition(wxSizer *sizer);
wxGBPosition GetItemPosition(size_t index);
- // Set the grid position of the specified item. Returns True on success.
- // If the move is not allowed (because an item is already there) then
- // False is returned.
+
%nokwargs SetItemPosition;
+ %noautodoc SetItemPosition;
+ DocStr(SetItemPosition,
+ "SetItemPosition(self, item, GBPosition pos) -> bool
+
+Set the grid position of the specified *item* where *item* is either a
+window or subsizer that is a member of this sizer, or a zero-based
+index of an item. Returns True on success. If the move is not
+allowed (because an item is already there) then False is returned.
+", "");
bool SetItemPosition(wxWindow *window, const wxGBPosition& pos);
bool SetItemPosition(wxSizer *sizer, const wxGBPosition& pos);
bool SetItemPosition(size_t index, const wxGBPosition& pos);
- // Get the row/col spanning of the specified item
+
+
%nokwargs GetItemSpan;
+ %noautodoc GetItemSpan;
+ DocStr(GetItemSpan,
+ "GetItemSpan(self, item) -> GBSpan
+
+Get the row/col spanning of the specified *item* where *item* is
+either a window or subsizer that is a member of this sizer, or a
+zero-based index of an item.", "");
wxGBSpan GetItemSpan(wxWindow *window);
wxGBSpan GetItemSpan(wxSizer *sizer);
wxGBSpan GetItemSpan(size_t index);
- // Set the row/col spanning of the specified item. Returns True on
- // success. If the move is not allowed (because an item is already there)
- // then False is returned.
+
+
%nokwargs SetItemSpan;
+ %noautodoc SetItemSpan;
+ DocStr(SetItemSpan,
+ "SetItemSpan(self, item, GBSpan span) -> bool
+
+Set the row/col spanning of the specified *item* where *item* is
+either a window or subsizer that is a member of this sizer, or a
+zero-based index of an item. Returns True on success. If the move is
+not allowed (because an item is already there) then False is returned.", "");
bool SetItemSpan(wxWindow *window, const wxGBSpan& span);
bool SetItemSpan(wxSizer *sizer, const wxGBSpan& span);
bool SetItemSpan(size_t index, const wxGBSpan& span);
+
- // Find the sizer item for the given window or subsizer, returns NULL if
- // not found. (non-recursive)
%nokwargs FindItem;
+ %noautodoc FindItem;
+ DocStr(FindItem,
+ "FindItem(self, item) -> GBSizerItem
+
+Find the sizer item for the given window or subsizer, returns None if
+not found. (non-recursive)", "");
wxGBSizerItem* FindItem(wxWindow* window);
wxGBSizerItem* FindItem(wxSizer* sizer);
- // Return the sizer item for the given grid cell, or NULL if there is no
- // item at that position. (non-recursive)
- wxGBSizerItem* FindItemAtPosition(const wxGBPosition& pos);
-
+ DocDeclStr(
+ wxGBSizerItem* , FindItemAtPosition(const wxGBPosition& pos),
+ "Return the sizer item for the given grid cell, or None if there is no
+item at that position. (non-recursive)", "");
- // Return the sizer item located at the point given in pt, or NULL if
- // there is no item at that point. The (x,y) coordinates in pt correspond
- // to the client coordinates of the window using the sizer for
- // layout. (non-recursive)
- wxGBSizerItem* FindItemAtPoint(const wxPoint& pt);
- // Return the sizer item that has a matching user data (it only compares
- // pointer values) or NULL if not found. (non-recursive)
- wxGBSizerItem* FindItemWithData(const wxObject* userData);
-
+ DocDeclStr(
+ wxGBSizerItem* , FindItemAtPoint(const wxPoint& pt),
+ "Return the sizer item located at the point given in *pt*, or None if
+there is no item at that point. The (x,y) coordinates in pt correspond
+to the client coordinates of the window using the sizer for
+layout. (non-recursive)", "");
- // These are what make the sizer do size calculations and layout
- virtual void RecalcSizes();
- virtual wxSize CalcMin();
+
+// DocDeclStr(
+// wxGBSizerItem* , FindItemWithData(const wxObject* userData),
+// "Return the sizer item that has a matching user data (it only compares
+// pointer values) or None if not found. (non-recursive)", "");
+
+
// Look at all items and see if any intersect (or would overlap) the given
// item. Returns True if so, False if there would be no overlap. If an
// excludeItem is given then it will not be checked for intersection, for
// example it may be the item we are checking the position of.
- %nokwargs CheckForIntersection;
- bool CheckForIntersection(wxGBSizerItem* item, wxGBSizerItem* excludeItem = NULL);
- bool CheckForIntersection(const wxGBPosition& pos, const wxGBSpan& span, wxGBSizerItem* excludeItem = NULL);
+
+
+ DocDeclStr(
+ bool , CheckForIntersection(wxGBSizerItem* item, wxGBSizerItem* excludeItem = NULL),
+ "Look at all items and see if any intersect (or would overlap) the
+given *item*. Returns True if so, False if there would be no overlap.
+If an *excludeItem* is given then it will not be checked for
+intersection, for example it may be the item we are checking the
+position of.
+", "");
+
+ DocDeclStrName(
+ bool , CheckForIntersection(const wxGBPosition& pos, const wxGBSpan& span, wxGBSizerItem* excludeItem = NULL),
+ "Look at all items and see if any intersect (or would overlap) the
+given position and span. Returns True if so, False if there would be
+no overlap. If an *excludeItem* is given then it will not be checked
+for intersection, for example it may be the item we are checking the
+position of.", "",
+ CheckForIntersectionPos);
+
};
//---------------------------------------------------------------------------
%newgroup;
+DocStr(wxSizerItem,
+"The wx.SizerItem class is used to track the position, size and other
+attributes of each item managed by a `wx.Sizer`. In normal usage user
+code should never need to deal directly with a wx.SizerItem, but
+custom classes derived from `wx.PySizer` will probably need to use the
+collection of wx.SizerItems held by wx.Sizer when calculating layout.
+
+:see: `wx.Sizer`, `wx.GBSizerItem`", "");
class wxSizerItem : public wxObject {
public:
- wxSizerItem();
+ DocCtorStr(
+ wxSizerItem(),
+ "Constructs an empty wx.SizerItem. Either a window, sizer or spacer
+size will need to be set before this item can be used in a Sizer.
+
+You will probably never need to create a wx.SizerItem directly as they
+are created automatically when the sizer's Add, Insert or Prepend
+methods are called.
+
+:see: `wx.SizerItemSpacer`, `wx.SizerItemWindow`, `wx.SizerItemSizer`", "");
+
+
- %name(SizerItemSpacer) wxSizerItem( int width, int height, int proportion, int flag, int border, wxObject* userData);
- %name(SizerItemWindow) wxSizerItem( wxWindow *window, int proportion, int flag, int border, wxObject* userData );
- %name(SizerItemSizer) wxSizerItem( wxSizer *sizer, int proportion, int flag, int border, wxObject* userData );
+ %extend {
+ DocStr(
+ wxSizerItem( wxWindow *window, int proportion, int flag,
+ int border, PyObject* userData=NULL ),
+ "Constructs a `wx.SizerItem` for tracking a window.", "");
+
+ %name(SizerItemWindow) wxSizerItem( wxWindow *window, int proportion, int flag,
+ int border, PyObject* userData=NULL ) {
+ wxPyUserData* data = NULL;
+ if ( userData ) {
+ bool blocked = wxPyBeginBlockThreads();
+ data = new wxPyUserData(userData);
+ wxPyEndBlockThreads(blocked);
+ }
+ return new wxSizerItem(window, proportion, flag, border, data);
+ }
+
+
+ DocStr(
+ wxSizerItem( int width, int height, int proportion, int flag,
+ int border, PyObject* userData=NULL),
+ "Constructs a `wx.SizerItem` for tracking a spacer.", "");
+ %name(SizerItemSpacer) wxSizerItem( int width, int height, int proportion, int flag,
+ int border, PyObject* userData=NULL) {
+ wxPyUserData* data = NULL;
+ if ( userData ) {
+ bool blocked = wxPyBeginBlockThreads();
+ data = new wxPyUserData(userData);
+ wxPyEndBlockThreads(blocked);
+ }
+ return new wxSizerItem(width, height, proportion, flag, border, data);
+ }
+
+ DocStr(
+ wxSizerItem( wxSizer *sizer, int proportion, int flag,
+ int border, PyObject* userData=NULL ),
+ "Constructs a `wx.SizerItem` for tracking a subsizer", "");
+ %name(SizerItemSizer) wxSizerItem( wxSizer *sizer, int proportion, int flag,
+ int border, PyObject* userData=NULL ) {
+ wxPyUserData* data = NULL;
+ if ( userData ) {
+ bool blocked = wxPyBeginBlockThreads();
+ data = new wxPyUserData(userData);
+ wxPyEndBlockThreads(blocked);
+ }
+ return new wxSizerItem(sizer, proportion, flag, border, data);
+ }
+ }
- void DeleteWindows();
- void DetachSizer();
- wxSize GetSize();
- wxSize CalcMin();
- void SetDimension( wxPoint pos, wxSize size );
+
+ DocDeclStr(
+ void , DeleteWindows(),
+ "Destroy the window or the windows in a subsizer, depending on the type
+of item.", "");
+
+ DocDeclStr(
+ void , DetachSizer(),
+ "Enable deleting the SizerItem without destroying the contained sizer.", "");
+
- wxSize GetMinSize();
- void SetInitSize( int x, int y );
+ DocDeclStr(
+ wxSize , GetSize(),
+ "Get the current size of the item, as set in the last Layout.", "");
+
+ DocDeclStr(
+ wxSize , CalcMin(),
+ "Calculates the minimum desired size for the item, including any space
+needed by borders.", "");
+
+ DocDeclStr(
+ void , SetDimension( wxPoint pos, wxSize size ),
+ "Set the position and size of the space allocated for this item by the
+sizer, and adjust the position and size of the item (window or
+subsizer) to be within that space taking alignment and borders into
+account.", "");
+
+
+ DocDeclStr(
+ wxSize , GetMinSize(),
+ "Get the minimum size needed for the item.", "");
+
+ DocDeclStr(
+ void , SetInitSize( int x, int y ),
+ "", "");
+
+ DocStr(SetRatio,
+ "Set the ratio item attribute.", "");
%name(SetRatioWH) void SetRatio( int width, int height );
%name(SetRatioSize) void SetRatio( wxSize size );
void SetRatio( float ratio );
- float GetRatio();
+
+ DocDeclStr(
+ float , GetRatio(),
+ "Set the ratio item attribute.", "");
+
- bool IsWindow();
- bool IsSizer();
- bool IsSpacer();
+ DocDeclStr(
+ bool , IsWindow(),
+ "Is this sizer item a window?", "");
+
+ DocDeclStr(
+ bool , IsSizer(),
+ "Is this sizer item a subsizer?", "");
+
+ DocDeclStr(
+ bool , IsSpacer(),
+ "Is this sizer item a spacer?", "");
+
- void SetProportion( int proportion );
- int GetProportion();
- %pythoncode { SetOption = SetProportion}
- %pythoncode { GetOption = GetProportion}
+ DocDeclStr(
+ void , SetProportion( int proportion ),
+ "Set the proportion value for this item.", "");
- void SetFlag( int flag );
- int GetFlag();
+ DocDeclStr(
+ int , GetProportion(),
+ "Get the proportion value for this item.", "");
- void SetBorder( int border );
- int GetBorder();
+ %pythoncode { SetOption = wx._deprecated(SetProportion, "Please use `SetProportion` instead.") }
+ %pythoncode { GetOption = wx._deprecated(GetProportion, "Please use `GetProportion` instead.") }
- wxWindow *GetWindow();
- void SetWindow( wxWindow *window );
- wxSizer *GetSizer();
- void SetSizer( wxSizer *sizer );
+ DocDeclStr(
+ void , SetFlag( int flag ),
+ "Set the flag value for this item.", "");
+
+ DocDeclStr(
+ int , GetFlag(),
+ "Get the flag value for this item.", "");
+
+
+ DocDeclStr(
+ void , SetBorder( int border ),
+ "Set the border value for this item.", "");
+
+ DocDeclStr(
+ int , GetBorder(),
+ "Get the border value for this item.", "");
- const wxSize& GetSpacer();
- void SetSpacer( const wxSize &size );
- void Show( bool show );
- bool IsShown();
+
+ DocDeclStr(
+ wxWindow *, GetWindow(),
+ "Get the window (if any) that is managed by this sizer item.", "");
+
+ DocDeclStr(
+ void , SetWindow( wxWindow *window ),
+ "Set the window to be managed by this sizer item.", "");
+
+
+ DocDeclStr(
+ wxSizer *, GetSizer(),
+ "Get the subsizer (if any) that is managed by this sizer item.", "");
+
+ DocDeclStr(
+ void , SetSizer( wxSizer *sizer ),
+ "Set the subsizer to be managed by this sizer item.", "");
+
+
+ DocDeclStr(
+ const wxSize& , GetSpacer(),
+ "Get the size of the spacer managed by this sizer item.", "");
+
+ DocDeclStr(
+ void , SetSpacer( const wxSize &size ),
+ "Set the size of the spacer to be managed by this sizer item.", "");
+
- wxPoint GetPosition();
+ DocDeclStr(
+ void , Show( bool show ),
+ "Set the show item attribute, which sizers use to determine if the item
+is to be made part of the layout or not. If the item is tracking a
+window then it is shown or hidden as needed.", "");
+
+ DocDeclStr(
+ bool , IsShown(),
+ "Is the item to be shown in the layout?", "");
+
+
+ DocDeclStr(
+ wxPoint , GetPosition(),
+ "Returns the current position of the item, as set in the last Layout.", "");
+
// wxObject* GetUserData();
%extend {
// Assume that the user data is a wxPyUserData object and return the contents
+
+ DocStr(GetUserData,
+ "Returns the userData associated with this sizer item, or None if there
+isn't any.", "");
PyObject* GetUserData() {
wxPyUserData* data = (wxPyUserData*)self->GetUserData();
if (data) {
+DocStr(wxSizer,
+"wx.Sizer is the abstract base class used for laying out subwindows in
+a window. You cannot use wx.Sizer directly; instead, you will have to
+use one of the sizer classes derived from it such as `wx.BoxSizer`,
+`wx.StaticBoxSizer`, `wx.NotebookSizer`, `wx.GridSizer`, `wx.FlexGridSizer`
+and `wx.GridBagSizer`.
+
+The concept implemented by sizers in wxWidgets is closely related to
+layout tools in other GUI toolkits, such as Java's AWT, the GTK
+toolkit or the Qt toolkit. It is based upon the idea of the individual
+subwindows reporting their minimal required size and their ability to
+get stretched if the size of the parent window has changed. This will
+most often mean that the programmer does not set the original size of
+a dialog in the beginning, rather the dialog will assigned a sizer and
+this sizer will be queried about the recommended size. The sizer in
+turn will query its children, which can be normal windows or contorls,
+empty space or other sizers, so that a hierarchy of sizers can be
+constructed. Note that wxSizer does not derive from wxWindow and thus
+do not interfere with tab ordering and requires very little resources
+compared to a real window on screen.
+
+What makes sizers so well fitted for use in wxWidgets is the fact that
+every control reports its own minimal size and the algorithm can
+handle differences in font sizes or different window (dialog item)
+sizes on different platforms without problems. If for example the
+standard font as well as the overall design of Mac widgets requires
+more space than on Windows, then the initial size of a dialog using a
+sizer will automatically be bigger on Mac than on Windows.", "
+
+:note: If you wish to create a custom sizer class in wxPython you
+ should derive the class from `wx.PySizer` in order to get
+ Python-aware capabilities for the various virtual methods.
+
+:see: `wx.SizerItem`
+
+:todo: More dscriptive text here along with some pictures...
+
+");
+
class wxSizer : public wxObject {
public:
// wxSizer(); **** abstract, can't instantiate
self->SetClientObject(new wxPyOORClientData(_self));
}
+ DocAStr(Add,
+ "Add(self, item, int proportion=0, int flag=0, int border=0,
+ PyObject userData=None)",
+
+ "Appends a child item to the sizer.", "
+
+ :param item: The item can be one of three kinds of objects:
+
+ - **window**: A `wx.Window` to be managed by the sizer. Its
+ minimal size (either set explicitly by the user or
+ calculated internally when constructed with wx.DefaultSize)
+ is interpreted as the minimal size to use when laying out
+ item in the sizer. This is particularly useful in
+ connection with `wx.Window.SetSizeHints`.
+
+ - **sizer**: The (child-)sizer to be added to the sizer. This
+ allows placing a child sizer in a sizer and thus to create
+ hierarchies of sizers (typically a vertical box as the top
+ sizer and several horizontal boxes on the level beneath).
+
+ - **size**: A `wx.Size` or a 2-element sequence of integers
+ that represents the width and height of a spacer to be added
+ to the sizer. Adding spacers to sizers gives more
+ flexibility in the design of dialogs; imagine for example a
+ horizontal box with two buttons at the bottom of a dialog:
+ you might want to insert a space between the two buttons and
+ make that space stretchable using the *proportion* value and
+ the result will be that the left button will be aligned with
+ the left side of the dialog and the right button with the
+ right side - the space in between will shrink and grow with
+ the dialog.
+
+ :param proportion: Although the meaning of this parameter is
+ undefined in wx.Sizer, it is used in `wx.BoxSizer` to indicate
+ if a child of a sizer can change its size in the main
+ orientation of the wx.BoxSizer - where 0 stands for not
+ changeable and a value of more than zero is interpreted
+ relative (a proportion of the total) to the value of other
+ children of the same wx.BoxSizer. For example, you might have
+ a horizontal wx.BoxSizer with three children, two of which are
+ supposed to change their size with the sizer. Then the two
+ stretchable windows should each be given *proportion* value of
+ 1 to make them grow and shrink equally with the sizer's
+ horizontal dimension. But if one of them had a *proportion*
+ value of 2 then it would get a double share of the space
+ available after the fixed size items are positioned.
+
+ :param flag: This parameter can be used to set a number of flags
+ which can be combined using the binary OR operator ``|``. Two
+ main behaviours are defined using these flags. One is the
+ border around a window: the *border* parameter determines the
+ border width whereas the flags given here determine which
+ side(s) of the item that the border will be added. The other
+ flags determine how the sizer item behaves when the space
+ allotted to the sizer changes, and is somewhat dependent on
+ the specific kind of sizer used.
+
+ +----------------------------+------------------------------------------+
+ |- wx.TOP |These flags are used to specify |
+ |- wx.BOTTOM |which side(s) of the sizer item that |
+ |- wx.LEFT |the *border* width will apply to. |
+ |- wx.RIGHT | |
+ |- wx.ALL | |
+ | | |
+ +----------------------------+------------------------------------------+
+ |- wx.EXAPAND |The item will be expanded to fill |
+ | |the space allotted to the item. |
+ +----------------------------+------------------------------------------+
+ |- wx.SHAPED |The item will be expanded as much as |
+ | |possible while also maintaining its |
+ | |aspect ratio |
+ +----------------------------+------------------------------------------+
+ |- wx.FIXED_MINSIZE |Normally wx.Sizers will use |
+ | |`wx.Window.GetMinSize` or |
+ | |`wx.Window.GetBestSize` to determine what |
+ | |the minimal size of window items should |
+ | |be, and will use that size to calculate |
+ | |the layout. This allows layouts to adjust |
+ | |when an item changes and it's best size |
+ | |becomes different. If you would rather |
+ | |have a window item stay the size it |
+ | |started with then use wx.FIXED_MINSIZE. |
+ +----------------------------+------------------------------------------+
+ |- wx.ALIGN_CENTER |The wx.ALIGN flags allow you to specify |
+ |- wx.ALIGN_LEFT |the alignment of the item within the space|
+ |- wx.ALIGN_RIGHT |allotted to it by the sizer, ajusted for |
+ |- wx.ALIGN_TOP |the border if any. |
+ |- wx.ALIGN_BOTTOM | |
+ |- wx.ALIGN_CENTER_VERTICAL | |
+ |- wx.ALIGN_CENTER_HORIZONTAL| |
+ +----------------------------+------------------------------------------+
+
+
+ :param border: Determines the border width, if the *flag*
+ parameter is set to include any border flag.
+
+ :param userData: Allows an extra object to be attached to the
+ sizer item, for use in derived classes when sizing information
+ is more complex than the *proportion* and *flag* will allow for.
+");
void Add(PyObject* item, int proportion=0, int flag=0, int border=0,
PyObject* userData=NULL) {
}
+ DocAStr(Insert,
+ "Insert(self, int before, item, int proportion=0, int flag=0, int border=0,
+ PyObject userData=None)",
+
+ "Inserts a new item into the list of items managed by this sizer before
+the item at index *before*. See `Add` for a description of the parameters.", "");
void Insert(int before, PyObject* item, int proportion=0, int flag=0,
int border=0, PyObject* userData=NULL) {
}
+
+ DocAStr(Prepend,
+ "Prepend(self, item, int proportion=0, int flag=0, int border=0,
+ PyObject userData=None)",
+ "Adds a new item to the begining of the list of sizer items managed by
+this sizer. See `Add` for a description of the parameters.", "");
void Prepend(PyObject* item, int proportion=0, int flag=0, int border=0,
PyObject* userData=NULL) {
proportion, flag, border, data);
}
-
+
+ DocAStr(Remove,
+ "Remove(self, item) -> bool",
+ "Removes an item from the sizer and destroys it. This method does not
+cause any layout or resizing to take place, call `Layout` to update
+the layout on screen after removing a child from the sizer. The
+*item* parameter can be either a window, a sizer, or the zero-based
+index of an item to remove. Returns True if the child item was found
+and removed.", "
+
+:note: For historical reasons calling this method with a `wx.Window`
+ parameter is depreacted, as it will not be able to destroy the
+ window since it is owned by its parent. You should use `Detach`
+ instead.
+");
bool Remove(PyObject* item) {
bool blocked = wxPyBeginBlockThreads();
wxPySizerItemInfo info = wxPySizerItemTypeHelper(item, False, True);
return False;
}
-
+
+ DocAStr(Detach,
+ "Detach(self, item) -> bool",
+ "Detaches an item from the sizer without destroying it. This method
+does not cause any layout or resizing to take place, call `Layout` to
+do so. The *item* parameter can be either a window, a sizer, or the
+zero-based index of the item to be detached. Returns True if the child item
+was found and detached.", "");
bool Detach(PyObject* item) {
bool blocked = wxPyBeginBlockThreads();
wxPySizerItemInfo info = wxPySizerItemTypeHelper(item, False, True);
}
}
- %name(AddItem) void Add( wxSizerItem *item );
- %name(InsertItem) void Insert( size_t index, wxSizerItem *item );
- %name(PrependItem) void Prepend( wxSizerItem *item );
+ %pythoncode {
+ def SetItemMinSize(self, item, *args):
+ """
+ SetItemMinSize(self, item, Size size)
+
+ Sets the minimum size that will be allocated for an item in the sizer.
+ The *item* parameter can be either a window, a sizer, or the
+ zero-based index of the item. If a window or sizer is given then it
+ will be searched for recursivly in subsizers if neccessary.
+ """
+ if len(args) == 2:
+ %# for backward compatibility accept separate width,height args too
+ return self._SetItemMinSize(item, args)
+ else:
+ return self._SetItemMinSize(item, args[0])
+ }
+
+ DocDeclAStrName(
+ void , Add( wxSizerItem *item ),
+ "AddItem(self, SizerItem item)",
+ "Adds a `wx.SizerItem` to the sizer.", "",
+ AddItem);
+
+ DocDeclAStrName(
+ void , Insert( size_t index, wxSizerItem *item ),
+ "InsertItem(self, int index, SizerItem item)",
+ "Inserts a `wx.SizerItem` to the sizer at the position given by *index*.", "",
+ InsertItem);
+
+ DocDeclAStrName(
+ void , Prepend( wxSizerItem *item ),
+ "PrependItem(self, SizerItem item)",
+ "Prepends a `wx.SizerItem` to the sizer.", "",
+ PrependItem);
+
%pythoncode {
- def AddMany(self, widgets):
+ def AddMany(self, items):
"""
AddMany is a convenience method for adding several items
to a sizer at one time. Simply pass it a list of tuples,
where each tuple consists of the parameters that you
would normally pass to the `Add` method.
"""
- for childinfo in widgets:
- if type(childinfo) != type(()) or (len(childinfo) == 2 and type(childinfo[0]) == type(1)):
- childinfo = (childinfo, )
- self.Add(*childinfo)
+ for item in items:
+ if type(item) != type(()) or (len(item) == 2 and type(item[0]) == type(1)):
+ item = (item, )
+ self.Add(*item)
%# for backwards compatibility only, please do not use in new code
AddWindow = wx._deprecated(Add, "AddWindow is deprecated, use `Add` instead.")
RemoveSizer = wx._deprecated(Remove, "RemoveSizer is deprecated, use `Remove` instead.")
RemovePos = wx._deprecated(Remove, "RemovePos is deprecated, use `Remove` instead.")
-
- def SetItemMinSize(self, item, *args):
- if len(args) == 2:
- return self._SetItemMinSize(item, args)
- else:
- return self._SetItemMinSize(item, args[0])
}
- void SetDimension( int x, int y, int width, int height );
- void SetMinSize( const wxSize &size );
+ DocDeclStr(
+ void , SetDimension( int x, int y, int width, int height ),
+ "Call this to force the sizer to take the given dimension and thus
+force the items owned by the sizer to resize themselves according to
+the rules defined by the parameter in the `Add`, `Insert` or `Prepend`
+methods.", "");
+
+ DocDeclStr(
+ void , SetMinSize( const wxSize &size ),
+ "Call this to give the sizer a minimal size. Normally, the sizer will
+calculate its minimal size based purely on how much space its children
+need. After calling this method `GetMinSize` will return either the
+minimal size as requested by its children or the minimal size set
+here, depending on which is bigger.", "");
+
- wxSize GetSize();
- wxPoint GetPosition();
- wxSize GetMinSize();
+ DocDeclStr(
+ wxSize , GetSize(),
+ "Returns the current size of the space managed by the sizer.", "");
+
+ DocDeclStr(
+ wxPoint , GetPosition(),
+ "Returns the current position of the sizer's managed space.", "");
+
+ DocDeclStr(
+ wxSize , GetMinSize(),
+ "Returns the minimal size of the sizer. This is either the combined
+minimal size of all the children and their borders or the minimal size
+set by SetMinSize, depending on which is bigger.", "");
+
%pythoncode {
def GetSizeTuple(self):
return self.GetMinSize().Get()
}
- virtual void RecalcSizes();
- virtual wxSize CalcMin();
+ DocDeclStr(
+ virtual void , RecalcSizes(),
+ "Using the sizes calculated by `CalcMin` reposition and resize all the
+items managed by this sizer. You should not need to call this directly as
+it is called by `Layout`.", "");
+
+ DocDeclStr(
+ virtual wxSize , CalcMin(),
+ "This method is where the sizer will do the actual calculation of its
+children's minimal sizes. You should not need to call this directly as
+it is called by `Layout`.", "");
+
+
+ DocDeclStr(
+ void , Layout(),
+ "This method will force the recalculation and layout of the items
+controlled by the sizer using the current space allocated to the
+sizer. Normally this is called automatically from the owning window's
+EVT_SIZE handler, but it is also useful to call it from user code when
+one of the items in a sizer change size, or items are added or
+removed.", "");
+
- void Layout();
+ DocDeclStr(
+ wxSize , Fit( wxWindow *window ),
+ "Tell the sizer to resize the *window* to match the sizer's minimal
+size. This is commonly done in the constructor of the window itself in
+order to set its initial size to match the needs of the children as
+determined by the sizer. Returns the new size.
- wxSize Fit( wxWindow *window );
- void FitInside( wxWindow *window );
+For a top level window this is the total window size, not the client size.", "");
+
+ DocDeclStr(
+ void , FitInside( wxWindow *window ),
+ "Tell the sizer to resize the *virtual size* of the *window* to match the
+sizer's minimal size. This will not alter the on screen size of the
+window, but may cause the addition/removal/alteration of scrollbars
+required to view the virtual area in windows which manage it.
+
+:see: `wx.ScrolledWindow.SetScrollbars`, `SetVirtualSizeHints`
+", "");
+
- void SetSizeHints( wxWindow *window );
- void SetVirtualSizeHints( wxWindow *window );
+ DocDeclStr(
+ void , SetSizeHints( wxWindow *window ),
+ "Tell the sizer to set (and `Fit`) the minimal size of the *window* to
+match the sizer's minimal size. This is commonly done in the
+constructor of the window itself if the window is resizable (as are
+many dialogs under Unix and frames on probably all platforms) in order
+to prevent the window from being sized smaller than the minimal size
+required by the sizer.", "");
+
+ DocDeclStr(
+ void , SetVirtualSizeHints( wxWindow *window ),
+ "Tell the sizer to set the minimal size of the window virtual area to
+match the sizer's minimal size. For windows with managed scrollbars
+this will set them appropriately.
+
+:see: `wx.ScrolledWindow.SetScrollbars`
+", "");
+
- void Clear( bool delete_windows=False );
- void DeleteWindows();
+ DocDeclStr(
+ void , Clear( bool deleteWindows=False ),
+ "Clear all items from the sizer, optionally destroying the window items
+as well.", "");
+
+ DocDeclStr(
+ void , DeleteWindows(),
+ "Destroy all windows managed by the sizer.", "");
+
// wxList& GetChildren();
%extend {
+ DocAStr(GetChildren,
+ "GetChildren(sefl) -> list",
+ "Returns a list of all the `wx.SizerItem` objects managed by the sizer.", "");
PyObject* GetChildren() {
wxSizerItemList& list = self->GetChildren();
return wxPy_ConvertList(&list);
}
- // Manage whether individual windows or sub-sizers are considered
+ // Manage whether individual windows or subsizers are considered
// in the layout calculations or not.
%extend {
+ DocAStr(Show,
+ "Show(self, item, bool show=True)",
+ "Shows or hides an item managed by the sizer. To make a sizer item
+disappear or reappear, use Show followed by `Layout`. The *item*
+parameter can be either a window, a sizer, or the zero-based index of
+the item.", "");
void Show(PyObject* item, bool show = True) {
bool blocked = wxPyBeginBlockThreads();
- wxPySizerItemInfo info = wxPySizerItemTypeHelper(item, False, False);
+ wxPySizerItemInfo info = wxPySizerItemTypeHelper(item, False, True);
wxPyEndBlockThreads(blocked);
if ( info.window )
self->Show(info.window, show);
else if ( info.sizer )
self->Show(info.sizer, show);
+ else if ( info.gotPos )
+ self->Show(info.pos, show);
}
-
-
- void Hide(PyObject* item) {
- bool blocked = wxPyBeginBlockThreads();
- wxPySizerItemInfo info = wxPySizerItemTypeHelper(item, False, False);
- wxPyEndBlockThreads(blocked);
- if ( info.window )
- self->Hide(info.window);
- else if ( info.sizer )
- self->Hide(info.sizer);
- }
-
-
+
+ DocAStr(IsShown,
+ "IsShown(self, item)",
+ "Determines if the item is currently shown. sizer. To make a sizer
+item disappear or reappear, use Show followed by `Layout`. The *item*
+parameter can be either a window, a sizer, or the zero-based index of
+the item.", "");
bool IsShown(PyObject* item) {
bool blocked = wxPyBeginBlockThreads();
wxPySizerItemInfo info = wxPySizerItemTypeHelper(item, False, False);
return self->IsShown(info.window);
else if ( info.sizer )
return self->IsShown(info.sizer);
+ else if ( info.gotPos )
+ return self->IsShown(info.pos);
else
return False;
}
}
+ %pythoncode {
+ def Hide(self, item):
+ """
+ A convenience method for Show(item, False).
+ """
+ self.Show(item, False)
+ }
- // Recursively call wxWindow::Show() on all sizer items.
- void ShowItems(bool show);
-
+
+ DocDeclStr(
+ void , ShowItems(bool show),
+ "Recursively call `wx.Window.Show` on all sizer items.", "");
+
};
%}
-
+DocStr(wxPySizer,
+"wx.PySizer is a special version of `wx.Sizer` that has been
+instrumented to allow the C++ virtual methods to be overloaded in
+Python derived classes. You would derive from this class if you are
+wanting to implement a custom sizer in Python code. Simply implement
+`CalcMin` and `RecalcSizes` in the derived class and you're all set.
+For example::
+
+ class MySizer(wx.PySizer):
+ def __init__(self):
+ wx.PySizer.__init__(self)
+
+ def CalcMin(self):
+ for item in self.GetChildren():
+ # calculate the total minimum width and height needed
+ # by all items in the sizer according to this sizer's
+ # layout algorithm.
+ ...
+ return wx.Size(width, height)
+
+ def RecalcSizes(self):
+ # find the space allotted to this sizer
+ pos = self.GetPosition()
+ size = self.GetSize()
+ for item in self.GetChildren():
+ # Recalculate (if necessary) the position and size of
+ # each item and then call item.SetDimension to do the
+ # actual positioning and sizing of the items within the
+ # space alloted to this sizer.
+ ...
+ item.SetDimension(itemPos, itemSize)
+
+
+When `Layout` is called it first calls `CalcMin` followed by
+`RecalcSizes` so you can optimize a bit by saving the results of
+`CalcMin` and resuing them in `RecalcSizes`.
+
+:see: `wx.SizerItem`, `wx.Sizer.GetChildren`
+
+", "");
class wxPySizer : public wxSizer {
public:
%pythonAppend wxPySizer "self._setCallbackInfo(self, PySizer);self._setOORInfo(self)"
- wxPySizer();
+ DocCtorStr(
+ wxPySizer(),
+ "Creates a wx.PySizer. Must be called from the __init__ in the derived
+class.", "");
+
void _setCallbackInfo(PyObject* self, PyObject* _class);
};
//---------------------------------------------------------------------------
%newgroup;
+
+DocStr(wxBoxSizer,
+"The basic idea behind a box sizer is that windows will most often be
+laid out in rather simple basic geometry, typically in a row or a
+column or nested hierarchies of either. A wx.BoxSizer will lay out
+its items in a simple row or column, depending on the orientation
+parameter passed to the constructor.", "
+
+It is the unique feature of a box sizer, that it can grow in both
+directions (height and width) but can distribute its growth in the
+main direction (horizontal for a row) *unevenly* among its children.
+This is determined by the proportion parameter give to items when they
+are added to the sizer. It is interpreted as a weight factor, i.e. it
+can be zero, indicating that the window may not be resized at all, or
+above zero. If several windows have a value above zero, the value is
+interpreted relative to the sum of all weight factors of the sizer, so
+when adding two windows with a value of 1, they will both get resized
+equally and each will receive half of the available space after the
+fixed size items have been sized. If the items have unequal
+proportion settings then they will receive a coresondingly unequal
+allotment of the free space.
+
+:see: `wx.StaticBoxSizer`
+");
+
class wxBoxSizer : public wxSizer {
public:
%pythonAppend wxBoxSizer "self._setOORInfo(self)"
- wxBoxSizer(int orient = wxHORIZONTAL);
+ DocCtorStr(
+ wxBoxSizer(int orient = wxHORIZONTAL),
+ "Constructor for a wx.BoxSizer. *orient* may be one of ``wx.VERTICAL``
+or ``wx.HORIZONTAL`` for creating either a column sizer or a row
+sizer.", "");
- int GetOrientation();
- void SetOrientation(int orient);
- void RecalcSizes();
- wxSize CalcMin();
+
+ DocDeclStr(
+ int , GetOrientation(),
+ "Returns the current orientation of the sizer.", "");
+
+ DocDeclStr(
+ void , SetOrientation(int orient),
+ "Resets the orientation of the sizer.", "");
+
};
//---------------------------------------------------------------------------
%newgroup;
+
+DocStr(wxStaticBoxSizer,
+"wx.StaticBoxSizer derives from and functions identically to the
+`wx.BoxSizer` and adds a `wx.StaticBox` around the items that the sizer
+manages. Note that this static box must be created separately and
+passed to the sizer constructor.", "");
+
class wxStaticBoxSizer : public wxBoxSizer {
public:
%pythonAppend wxStaticBoxSizer "self._setOORInfo(self)"
- wxStaticBoxSizer(wxStaticBox *box, int orient = wxHORIZONTAL);
+ DocCtorStr(
+ wxStaticBoxSizer(wxStaticBox *box, int orient = wxHORIZONTAL),
+ "Constructor. It takes an associated static box and the orientation
+*orient* as parameters - orient can be either of ``wx.VERTICAL`` or
+``wx.HORIZONTAL``.", "");
- wxStaticBox *GetStaticBox();
- void RecalcSizes();
- wxSize CalcMin();
+ DocDeclStr(
+ wxStaticBox *, GetStaticBox(),
+ "Returns the static box associated with this sizer.", "");
+
};
//---------------------------------------------------------------------------
%newgroup;
+
+DocStr(wxGridSizer,
+"A grid sizer is a sizer which lays out its children in a
+two-dimensional table with all cells having the same size. In other
+words, the width of each cell within the grid is the width of the
+widest item added to the sizer and the height of each grid cell is the
+height of the tallest item. An optional vertical and/or horizontal
+gap between items can also be specified (in pixels.)
+
+Items are placed in the cells of the grid in the order they are added,
+in row-major order. In other words, the first row is filled first,
+then the second, and so on until all items have been added. (If
+neccessary, additional rows will be added as items are added.) If you
+need to have greater control over the cells that items are placed in
+then use the `wx.GridBagSizer`.
+", "");
+
class wxGridSizer: public wxSizer
{
public:
%pythonAppend wxGridSizer "self._setOORInfo(self)"
- wxGridSizer( int rows=1, int cols=0, int vgap=0, int hgap=0 );
-
- void RecalcSizes();
- wxSize CalcMin();
-
- void SetCols( int cols );
- void SetRows( int rows );
- void SetVGap( int gap );
- void SetHGap( int gap );
- int GetCols();
- int GetRows();
- int GetVGap();
- int GetHGap();
+ DocCtorStr(
+ wxGridSizer( int rows=1, int cols=0, int vgap=0, int hgap=0 ),
+ "Constructor for a wx.GridSizer. *rows* and *cols* determine the number
+of columns and rows in the sizer - if either of the parameters is
+zero, it will be calculated to from the total number of children in
+the sizer, thus making the sizer grow dynamically. *vgap* and *hgap*
+define extra space between all children.", "");
+
+ DocDeclStr(
+ void , SetCols( int cols ),
+ "Sets the number of columns in the sizer.", "");
+
+ DocDeclStr(
+ void , SetRows( int rows ),
+ "Sets the number of rows in the sizer.", "");
+
+ DocDeclStr(
+ void , SetVGap( int gap ),
+ "Sets the vertical gap (in pixels) between the cells in the sizer.", "");
+
+ DocDeclStr(
+ void , SetHGap( int gap ),
+ "Sets the horizontal gap (in pixels) between cells in the sizer", "");
+
+ DocDeclStr(
+ int , GetCols(),
+ "Returns the number of columns in the sizer.", "");
+
+ DocDeclStr(
+ int , GetRows(),
+ "Returns the number of rows in the sizer.", "");
+
+ DocDeclStr(
+ int , GetVGap(),
+ "Returns the vertical gap (in pixels) between the cells in the sizer.", "");
+
+ DocDeclStr(
+ int , GetHGap(),
+ "Returns the horizontal gap (in pixels) between cells in the sizer.", "");
+
};
//---------------------------------------------------------------------------
};
+
+
+
+DocStr(wxFlexGridSizer,
+"A flex grid sizer is a sizer which lays out its children in a
+two-dimensional table with all table cells in one row having the same
+height and all cells in one column having the same width, but all
+rows or all columns are not necessarily the same height or width as in
+the `wx.GridSizer`.
+
+wx.FlexGridSizer can also size items equally in one direction but
+unequally (\"flexibly\") in the other. If the sizer is only flexible
+in one direction (this can be changed using `SetFlexibleDirection`), it
+needs to be decided how the sizer should grow in the other (\"non
+flexible\") direction in order to fill the available space. The
+`SetNonFlexibleGrowMode` method serves this purpose.
+
+", "");
+
class wxFlexGridSizer: public wxGridSizer
{
public:
%pythonAppend wxFlexGridSizer "self._setOORInfo(self)"
- wxFlexGridSizer( int rows=1, int cols=0, int vgap=0, int hgap=0 );
+ DocCtorStr(
+ wxFlexGridSizer( int rows=1, int cols=0, int vgap=0, int hgap=0 ),
+ "Constructor for a wx.FlexGridSizer. *rows* and *cols* determine the
+number of columns and rows in the sizer - if either of the parameters
+is zero, it will be calculated to from the total number of children in
+the sizer, thus making the sizer grow dynamically. *vgap* and *hgap*
+define extra space between all children.", "");
+
+
+ DocDeclStr(
+ void , AddGrowableRow( size_t idx, int proportion = 0 ),
+ "Specifies that row *idx* (starting from zero) should be grown if there
+is extra space available to the sizer.
+
+The *proportion* parameter has the same meaning as the stretch factor
+for the box sizers except that if all proportions are 0, then all
+columns are resized equally (instead of not being resized at all).", "");
- void RecalcSizes();
- wxSize CalcMin();
+ DocDeclStr(
+ void , RemoveGrowableRow( size_t idx ),
+ "Specifies that row *idx* is no longer growable.", "");
+
+ DocDeclStr(
+ void , AddGrowableCol( size_t idx, int proportion = 0 ),
+ "Specifies that column *idx* (starting from zero) should be grown if
+there is extra space available to the sizer.
+
+The *proportion* parameter has the same meaning as the stretch factor
+for the box sizers except that if all proportions are 0, then all
+columns are resized equally (instead of not being resized at all).", "");
+
+ DocDeclStr(
+ void , RemoveGrowableCol( size_t idx ),
+ "Specifies that column *idx* is no longer growable.", "");
+
+
+ DocDeclStr(
+ void , SetFlexibleDirection(int direction),
+ "Specifies whether the sizer should flexibly resize its columns, rows,
+or both. Argument *direction* can be one of the following values. Any
+other value is ignored.
+
+ ============== =======================================
+ wx.VERTICAL Rows are flexibly sized.
+ wx.HORIZONTAL Columns are flexibly sized.
+ wx.BOTH Both rows and columns are flexibly sized
+ (this is the default value).
+ ============== =======================================
+
+Note that this method does not trigger relayout.
+", "");
+
+ DocDeclStr(
+ int , GetFlexibleDirection(),
+ "Returns a value that specifies whether the sizer
+flexibly resizes its columns, rows, or both (default).
- void AddGrowableRow( size_t idx, int proportion = 0 );
- void RemoveGrowableRow( size_t idx );
- void AddGrowableCol( size_t idx, int proportion = 0 );
- void RemoveGrowableCol( size_t idx );
+:see: `SetFlexibleDirection`", "");
- // the sizer cells may grow in both directions, not grow at all or only
- // grow in one direction but not the other
+
- // the direction may be wxVERTICAL, wxHORIZONTAL or wxBOTH (default)
- void SetFlexibleDirection(int direction);
- int GetFlexibleDirection();
+ DocDeclStr(
+ void , SetNonFlexibleGrowMode(wxFlexSizerGrowMode mode),
+ "Specifies how the sizer should grow in the non-flexible direction if
+there is one (so `SetFlexibleDirection` must have been called
+previously). Argument *mode* can be one of the following values:
+
+ ========================== =================================================
+ wx.FLEX_GROWMODE_NONE Sizer doesn't grow in the non flexible direction.
+ wx.FLEX_GROWMODE_SPECIFIED Sizer honors growable columns/rows set with
+ `AddGrowableCol` and `AddGrowableRow`. In this
+ case equal sizing applies to minimum sizes of
+ columns or rows (this is the default value).
+ wx.FLEX_GROWMODE_ALL Sizer equally stretches all columns or rows in
+ the non flexible direction, whether they are
+ growable or not in the flexbile direction.
+ ========================== =================================================
+
+Note that this method does not trigger relayout.
+
+", "");
+
+ DocDeclStr(
+ wxFlexSizerGrowMode , GetNonFlexibleGrowMode(),
+ "Returns the value that specifies how the sizer grows in the
+non-flexible direction if there is one.
- // note that the grow mode only applies to the direction which is not
- // flexible
- void SetNonFlexibleGrowMode(wxFlexSizerGrowMode mode);
- wxFlexSizerGrowMode GetNonFlexibleGrowMode();
+:see: `SetNonFlexibleGrowMode`", "");
+
// Read-only access to the row heights and col widths arrays
- const wxArrayInt& GetRowHeights() const;
- const wxArrayInt& GetColWidths() const;
+ DocDeclAStr(
+ const wxArrayInt& , GetRowHeights() const,
+ "GetRowHeights(self) -> list",
+ "Returns a list of integers representing the heights of each of the
+rows in the sizer.", "");
+
+ DocDeclAStr(
+ const wxArrayInt& , GetColWidths() const,
+ "GetColWidths(self) -> list",
+ "Returns a list of integers representing the widths of each of the
+columns in the sizer.", "");
+
};
//---------------------------------------------------------------------------
projects / wxWidgets.git / commitdiff
