The View is a representation of Cocoa’s NSView. It isn’t meant to be instatiated directly, but to be subclassed.
| Parameters: |
|---|
Every view has a parent, which in Cocoa is called superview. x and y are usually set by layout methods, so we don’t care about them (they’re initialized to 0). However the size of a widget is important to know before starting the layout process, so we add them to the constructor. Many subclasses have defaults for their size, so it’s not because the View asks for it that every subclass does so.
View instance. The superview of the view. It can be None. When set, the view will automatically be added to its superview upon creation.
Numeric. The X position of the view. In Cocoa: frame.origin.x.
Numeric. The y position of the view. In Cocoa: frame.origin.y.
Numeric. The width of the view. In Cocoa: frame.size.width.
Numeric. The height of the view. In Cocoa: frame.size.height.
Boolean. Use this attribute to override default “fixed” values, usually for layout purposes. By default, a view is not fixed, but you could want a layout to not automatically resize a view like it does by default. In this case, you would set this attribute to False. Also, Control subclasses have a fixed height, which means that by default, its height isn’t modified by layouts. You could want to override this to True, for example, if you want a TextField to grow vertically in a layout.
Menu. The contextual menu for the view.
Instance or accessor. View’s delegate, which has a different role depending on the subclass. The value for this attribute can be either another instance, or a reference, such as owner or owner.something.
Cocoa constant. Type of border glow that shows up when the view has focus. Use NSFocusRingType constants.
String. The string that is spoken out by Voice Over when the view is selected. Equivalent to the “Description” field in “Accessibility Identity” in XCode’s IB.
| Parameters: |
|
|---|
Binds self’s name attribute to target‘s keyPath attribute. To bind something to a User Defaults value, use the global defaults accessor. For example, if you want to bind the font size of a button to a default value, you’d do button.bind('fontSize', defaults, 'values.ButtonFontSizePref')
For now, not all binding options are supported, only the valueTransformer one. The value you have to give to that argument is the value transformer’s name (the same name you’d give to XCode’s interface builder).
| Parameters: |
|
|---|
Move the view in the specified direction, which is one of the Side constants (if you specify a corner, it is equivalent to 2 moveTo() calls with the 2 sides corresponding to the corner).
If you specify a target argument, you’re sending the view to an absolute position. For example, moveTo(Pack.Left, target=42) sets x to 42. (note that in the case of Right and Above, the absolute position is for the right and upper bounds of the view. So, for example, calling moveTo(Pack.Above, target=42) actually sets y to 42 - view.height).
Without a target argument, the view is moved until it hits its parent bounds (respecting the margins). For example, moveTo(Pack.Right) sends the view to the right side of its superview. You can specify a margin argument to override default margins.
Note that this method doesn’t care if there’s already something where it moves, so if you send two views in the same place, they’re going to overlap. To place views relatively to each other, use moveNextTo().
| Parameters: |
|
|---|
Sends the view at the side of another view, specified by other. The way the view is placed next to the other is specified by side and align. side tells at which side of other we want our view to be. For example, if it’s Pack.Below, our view is going to be placed under other. align tells how our view, if it’s not the same size as other, is going to be aligned. If we countinue our “below” example and align our view with Pack.Right, our view’s right side is going to be aligned with other‘s right side. As you probably guessed, align has to be of a different orientation than side. It doesn’t make any sense to side at Pack.Below and align at Pack.Above.
The align argument is optional. If it’s not supplied, it will default to Left if side is vertical and Middle otherwise.
You can override default margins by specifying a margin argument.
Deprecated. Same as moveNextTo().
| Parameters: |
|
|---|
Makes the view grow in a direction specified by size until it reaches its superview’s bounds (respecting the margins, of course). The nice thing about fill is that if you used packRelativeTo() to pack views at the view’s side you’re trying to fill, these views are going to count in the filling process. For example, if you have a button packed at your right and you’re filling to the right, the gain in width will be decerased by the button’s width and margin and the button will be moved to the right to accomodate your growth.
Using a corner constant instead of a size one is a shorthand for calling fill() twice. For example, calling fill(Pack.LowerRight) is the same as calling both fill(Pack.Below) and fill(Pack.Right).
You can override default margins by specifying a margin argument.
You can also override the goal of the filling operation, that is, the point it’s trying to reach when it enlarges or shrink. Most of the time, you’re not going to need it, but for complex layouts, you might, mostly for operations like “fill my view exactly at the same point at this other view over there”.
| Parameters: |
|
|---|
This is a shortcut to:
self.moveTo(Pack.UpperLeft)
self.fill(Pack.LowerRight)
which simply takes all the space in the parent view. You can specify a margin like you’d do with moveTo() and fill(). If setAnchor is True, an anchor growing on all sides will be set.
| Parameters: |
|
|---|
Sets the view autoresizing mask. The corner you specify will be the corner the view “stick to” when its parent view is resized. If growX and/or growY is True, the view will grow or shrink with its parent view.
Note that with views that have a fixed height or a fixed width, growY and growX arguments will have respectively no effect and will always be set to False. This is to avoid weird anchor rules in layouts with fillers. If you want to override the fixed nature or a view’s size, make sure you override the appropriate flag where supported (for example View.fixedHeight) before you call setAnchor().