VMargin
Bases:
NoneWidget
Vertical margin widget. VMargin only accepts margin, not padding.
Note
VMargin does not accept any transformation.
Adds a function to the Widget to be executed each time the widget is drawn.
The function that this method receives two objects: the Widget itself and the Menu reference.
import math def draw_update_function(widget, menu): t = widget.get_attribute('t', 0) t += menu.get_clock().get_time() widget.set_padding(10*(1 + math.sin(t))) # Oscillating padding button = menu.add.button('This button updates its padding', None) button.set_draw_callback(draw_update_function)
After creating a new callback, this functions returns the ID of the call. It can be removed anytime using
pygame_menu.widgets.core.widget.Widget.remove_draw_callback()
.Note
If Menu surface cache is enabled this method may run only once. To force running the added method each time call
widget.force_menu_surface_update()
to force Menu update the cache status if the drawing callback does not make the Widget to render. Remember that rendering the Widget forces the Menu to update its surface, thus updating the cache too.
Adds a function to the Widget to be executed each time the Widget is updated.
The function that this method receives three objects: the events list, the Widget itself and the Menu reference. It is similar to
pygame_menu.widgets.core.widget.Widget.add_draw_callback()
.After creating a new callback, this functions returns the ID of the call. It can be removed anytime using
pygame_menu.widgets.core.widget.Widget.remove_update_callback()
.Note
Not all widgets are updated, so the provided function may never be executed in some widgets (for example, label or images).
Apply callbacks on Widget draw.
- Return type:
- Returns:
Self reference
Apply callbacks on Widget update.
Note
Readonly widgets or hidden widgets do not apply update callbacks.
Draw the Widget on a given surface.
Note
Widget drawing order:
Background color
prev
decoratorWidget selection effect (if prev)
Widget surface
Widget selection effect (if post)
Widget border
post
decorator
- Parameters:
surface (
Surface
) – Surface to draw- Return type:
- Returns:
Self reference
Forces menu surface cache to update after next drawing call. This also updates widget decoration.
Note
This method only updates the surface cache, without forcing re-rendering of all Menu widgets as
pygame_menu.widgets.core.widget.Widget.force_menu_surface_update()
does.- Return type:
- Returns:
Self reference
Forces menu surface update after next rendering call. This method automatically updates widget decoration cache as Menu render forces it to re-render.
This method also should be called by each widget after render.
Note
This method is expensive, as menu surface update forces re-rendering of all widgets (because them can change in size, position, etc…).
- Return type:
- Returns:
Self reference
Return the Widget alignment.
- Return type:
- Returns:
Widget align
Get an attribute value.
Return the Class+ID as a string.
- Return type:
- Returns:
Class+ID format
Get the Widget column/row position.
Return the widget controller. Each widget has their own controller object.
- Return type:
- Returns:
Controller object
Get counter attribute.
Return the Widget decorator API.
- Return type:
- Returns:
Decorator API
Get container frame of Widget. If Widget is not within a Frame, the method returns
None
.- Returns:
Frame object
- Return type:
Get frame depth (If frame is packed within another frame).
- Return type:
- Returns:
Frame depth
Return the object ID.
- Return type:
- Returns:
Object ID
Return the Menu reference,
None
if it has not been set.
Return the widget position tuple on x-axis and y-axis (x, y) in px.
- Parameters:
apply_padding (
bool
) – Apply widget padding to positionuse_transformed_padding (
bool
) – Use scaled padding if the widget is scaledto_real_position (
bool
) – Get the real position within window (not the surface container)to_absolute_position (
bool
) – Get the absolute position within surface container, considering also the parent scrollarea positioningreal_position_visible (
bool
) – Return only the visible width/height ifto_real_position=True
- Return type:
- Returns:
Widget position
Return the scrollarea object.
- Return type:
- Returns:
ScrollArea object
Return
True
if the object has the given attribute.
Hides the Widget.
- Return type:
- Returns:
Self reference
Return
True
if the Widget is floating.- Return type:
- Returns:
Float status
Return
True
if the Widget is visible.
Function executed if the Widget is removed from the Menu.
- Return type:
- Returns:
Self reference
Removes the given attribute from the object. Throws
IndexError
if the given key does not exist.- Parameters:
key (
str
) – Key of the attribute- Return type:
Base
- Returns:
Self reference
Removes draw callback from ID.
Removes update callback from ID.
The container ScrollArea scrolls to the Widget.
Set the alignment of the Widget.
Note
Alignment is only applied when updating the widget position, done by Menu when rendering the surface. Thus, the alignment change is not immediate.
Note
Use
pygame_menu.widgets.core.widget.Widget.render()
method to force widget rendering after calling this method.Note
See
pygame_menu.locals
for validalign
values.
Set an attribute.
Set the (column, row, index) position. If the column or row is
-1
then the widget is not assigned to a certain column/row (for example, if it’s hidden).
Set a new controller object.
- Parameters:
controller (
Controller
) – Controller- Return type:
- Returns:
Self reference
Set the floating status. If
True
the Widget don’t contribute its width/height to the Menu widget positioning computation (for example, the surface area or the column/row layout), and don’t add one unit to the rows (use the same vertical place as the previous widget).For example, before floating:
---------------------------- | wid1 | wid3 | | wid2 | wid4 | ----------------------------
After
wid3.set_float(True)
:---------------------------- | wid1 | wid4 | | wid2,wid3 | | ----------------------------
If the Widget is within a Frame, it does not contribute to the width/height of the layout. Also, it is being set to the (0, 0) position, thus, the only way to move the Widget to a desired position is by translating it.
- Parameters:
- Return type:
Set Widget frame.
Set the Widget menu reference.
Set scrollarea reference. Mostly used for events.
- Parameters:
scrollarea (
Optional
[ScrollArea
]) – Scrollarea object- Return type:
Set the Widget visible.
- Return type:
- Returns:
Self reference