Class Frame provides three methods, place, place_row
and place_column, for adding and laying out subcomponents. These
methods accept a very flexible set of options for specifying the position
and size of the subcomponents, adding scroll bars and borders to them,
and controlling how they behave when the containing frame is resized.
- These options specify the initial positions of the edges of a component. They may take one of four forms:
It is important to understand that these options only control the initial position and size of the component. Specifying and edge relative to another component does not create any sort of connection or constraint between the two components. Whether the relationship will be maintained when the frame is subsequently resized depends entirely on the value of the sticky option (see below).
This is the default value, and it leaves the edge unspecified. The position of an unspecified edge is determined by the component's current size and the positioning of the opposite edge. If the opposite edge is unspecified as well, the positions of both edges are left as they are.
- A distance
The edge is positioned at the specified distance from one of the edges of the containing frame. Which edge of the frame is used depends on the value of distance. Positive distances are measured from the left or top edge of the frame, whereas negative distances are measured from the right or bottom edge of the frame.
A distance of zero is measured from the corresponding edge to the one being specified -- for example, specifying left = 0 positions the left edge of the component at the left edge of the frame, and specifying right = 0 positions the right edge of the component at the right edge of the frame.
- A component
The edge is aligned with the opposite edge of the specified component. For example, specifying left = my_button aligns the left edge of the component with the right edge of my_button.
- An expression of the form component + distance or component - distance
The edge is positioned at the specified distance from the opposite edge of the specified component. For example, specifying left = my_button + 10 positions the left edge of the component 10 pixels to the right of the right edge of my_button, and specifying bottom = my_label - 20 positions the bottom edge of the component 20 pixels above the top edge of my_label.
- Note also that the left, top, right, and bottom options to the placement methods are quite different from the left, top, right, and bottom properties of components. The special forms described above can be used only with the former and not with the latter.
- This option controls what happens to the position and size of the component when the frame is subsequently resized. It consists of a string made up of the letters 'n', 's', 'e' and 'w' for north, south, east and west.
- If sticky contains 'w' but not 'e', the component will "stick" to the left edge of the frame, meaning that its position and size in the horizontal direction will not change when the frame is resized. If it contains 'e' but not 'w', the component will stick to the right edge of the frame, meaning that it will move along with the right edge of the frame while retaining its size.
- If sticky contains both 'e' and 'w', the component's left edge will stick to the left edge of the frame, and its right edge will stick to the right edge of the frame. The component will therefore stretch or shrink in the horizontal direction when the frame changes size.
- Similar considerations apply to the letters 'n' and 's' with regard to the vertical direction.
- The default value of sticky is 'nw', so that the component sticks to the top and left edges of the frame.
- This option is a string made up of the letters 'h' and 'v' specifying horizontal and vertical scrolling, respectively. It should only be used when the component being placed is a subclass of ScrollableView, or some other component that supports scrolling. The effect of using it on a component that does not support scrolling is undefined.
- This is a boolean option requesting that the component be given a border. Whether a border is actually added, and if so, its size and appearance, depends on the platform and on the type of component being placed. When a border is provided, it exists outside the bounds of the component, and is not included in the calculation of any component's position and size.
Placing a row or column is achieved by first placing one of the components as specified by the given options, and then placing each subsequent component relative to the previous one. All of the same placement options are applied to each subsequent component, except for one of its edges, which will be positioned at the specified spacing from the previous component.
- The amount of space to leave between adjacent components. If unspecified, a platform-dependent default is used.