changed: - Properties: dGridSizer shares most of the same properties as [dSizer], but also has some specific to it. These are listed first. _Only in dGridSizer_ - <a href="#HGap">!HGap</a> - <a href="#VGap">!VGap</a> - <a href="#MaxCols">!MaxCols</a> - <a href="#MaxRows">!MaxRows</a> - <a href="#MaxDimension">!MaxDimension</a> _Usage different in dGridSizer_ - <a href="#Orientation">Orientation</a> _Same meaning in both dSizer and dGridSizer_ - <a href="#Visible">Visible</a> - <a href="#Children">Children</a> - <a href="#!ChildWindows">!ChildWindows</a> - <a href="#!ControllingSizer">!ControllingSizer</a> - <a href="#!ControllingSizerItem">!ControllingSizerItem</a> - <a href="#Parent">Parent</a> - <a href="#Border">Border</a> - <a href="#!BorderRight">!BorderRight</a> - <a href="#!BorderLeft">!BorderLeft</a> - <a href="#!BorderTop">!BorderTop</a> - <a href="#!BorderBottom">!BorderBottom</a> - <a href="#Spacing">Spacing</a> - <a href="#Height">Height</a> - <a href="#Width">Width</a> <table border="1" cellpadding="3"> <tr bgcolor="lightgray"> <th>Property</th> <th>Frequency Used</th> <th>Type</th> <th>Description</th> </tr> <tr> <td><a name="HGap"><b>!HGap</b></a></td> <td>Frequently</td> <td>int</td> <td>Horizontal gap between cells. Can also be thought of as the spacing between columns.</td> </tr> <tr> <td><a name="VGap"><b>!VGap</b></a></td> <td>Frequently</td> <td>int</td> <td>Vertical gap between cells. Can also be thought of as the spacing between rows.</td> </tr> <tr> <td><a name="MaxCols"><b>!MaxCols</b></a></td> <td>Frequently</td> <td>int</td> <td>When adding objects to the grid sizer, controls the maximum number of columns to add before a new row is started.</td> </tr> <tr> <td><a name="MaxRows"><b>!MaxRows</b></a></td> <td>Frequently</td> <td>int</td> <td>When adding objects to the grid sizer, controls the maximum number of rows to add before a new column is started.</td> </tr> <tr> <td><a name="MaxDimension"><b>!MaxDimension</b></a></td> <td>Frequently</td> <td>string</td> <td>When appending objects to the grid sizer, this property determines whether we use !MaxCols or !MaxRows as the limiting value before starting a new row or column.</td> </tr> <tr> <td><a name="Orientation"><b>Orientation</b></a></td> <td>Rarely</td> <td>string</td> <td>This is an alias for <b>!MaxDimension</b>. It is better to use that instead, to avoid confusion with the meaning of Orientation with one-dimensional sizers.</td> </tr> <tr> <td><a name="Visible"><b>Visible</b></a></td> <td>Occasionally</td> <td>bool</td> <td>Controls the visibility of all the items controlled by this sizer. In other words, setting 'Visible = False' hides all of the items controlled by this sizer.</td> </tr> <tr> <td colspan="4" bgcolor="gray"></td> </tr> <tr> <td><a name="Children"><b>Children</b></a></td> <td>Rarely</td> <td>list of SizerItem objects</td> <td>Returns a list of all SizerItem objects for this sizer. Can be useful in some instances, but generally, !ChildWindows is what you'll need.</td> </tr> <tr> <td><a name="!ChildWindows"><b>!ChildWindows</b></a></td> <td>Frequently</td> <td>list of controls</td> <td>Returns a list of all controls directly managed by this sizer. Ignores spacers and nested sizers.</td> </tr> <tr> <td colspan="4" bgcolor="gray"></td> </tr> <tr> <td><a name="!ControllingSizer"><b>!ControllingSizer</b></a></td> <td>Sometimes</td> <td>dSizer or dGridSizer</td> <td>Returns a reference to the sizer that manages this sizer, or None if it is not nested inside another sizer.</td> </tr> <tr> <td><a name="!ControllingSizerItem"><b>!ControllingSizerItem</b></a></td> <td>Sometimes</td> <td>SizerItem</td> <td>Returns a reference to the SizerItem the controls the layout of this sizer, or None if it is not nested inside another sizer.</td> </tr> <tr> <td><a name="Parent"><b>Parent</b></a></td> <td>Rarely</td> <td>some UI control</td> <td>Returns a reference to the control that this sizer is contained in. In the case of nested sizers, it traverses the nesting to find the ultimate UI control this sizer is contained within.</td> </tr> <tr> <td colspan="4" bgcolor="gray"></td> </tr> <tr> <td><a name="Border"><b>Border</b></a></td> <td>Sometimes</td> <td>int</td> <td>Default=0. Sets a default value for the border that will be applied to any controls added to the sizer afterwards. Note that it **does not** affect the border of items already added to the control.<br>This property is useful when you want to add a series of items to a sizer with the same border: just set this property once, and then add your items.</td> </tr> <tr> <td><a name="!BorderRight"><b>!BorderRight</b></a></td> <td>Sometimes</td> <td>bool</td> <td>Default=True. Affects whether the Border property is applied to the Right side of controls added to the sizer.</td> </tr> <tr> <td><a name="!BorderLeft"><b>!BorderLeft</b></a></td> <td>Sometimes</td> <td>bool</td> <td>Default=True. Affects whether the Border property is applied to the Left side of controls added to the sizer.</td> </tr> <tr> <td><a name="!BorderTop"><b>!BorderTop</b></a></td> <td>Sometimes</td> <td>bool</td> <td>Default=True. Affects whether the Border property is applied to the Top side of controls added to the sizer.</td> </tr> <tr> <td><a name="!BorderBottom"><b>!BorderBottom</b></a></td> <td>Sometimes</td> <td>bool</td> <td>Default=True. Affects whether the Border property is applied to the Bottom side of controls added to the sizer.</td> </tr> <tr> <td><a name="Spacing"><b>Spacing</b></a></td> <td>Sometimes</td> <td>int</td> <td>Default=0. Sets a default value for the spacing that will be added before any controls added to the sizer afterwards. Note that it **does not** affect the spacing of items already added to the control.<br>This property is useful when you want to add a series of items to a sizer with the same spacing between them: just set this property once, and then add your items.</td> </tr> <tr> <td colspan="4" bgcolor="gray"></td> </tr> <tr> <td><a name="Height"><b>Height</b></a></td> <td>Rarely</td> <td>int</td> <td>Read-Only. Returns the height in pixels of the area controlled by the sizer.</td> </tr> <tr> <td><a name="Width"><b>Width</b></a></td> <td>Rarely</td> <td>int</td> <td>Read-Only. Returns the width in pixels of the area controlled by the sizer.</td> </tr> </table>