Label

CactusGUI element for drawing text labels to the screen

Example Code:


gui.makeLabel('myLabel')
gui['myLabel'].style(owner='main', text='label text here', top=50, left=100, color=(255,0,0))

Attributes:

Label - Specific Type Attributes:
Attribute Datatype Comments
text string Text to display
color color (R,G,B) Color of the text (R,G,B)
font pygame.font.Font Font for the label. Use pygame.font.Font()
height int  
width int  
top int  
bottom int  
centery int  
left int  
right int  
centerx int  
image_offset_left int  
image_offset_top int  
target string Name of another element. When the current element would be focused, the target element will focus instead.
GUI Primary Attributes:
Attribute Datatype Comments
name string Identifies the element inside the GUI
owner string Name of the element that "owns" the current element
type string The specific kind of element - ex: Textbox, Button, Image, State, etc.
z_order int Determines the layering order of the element when GUI elements with the same owner are rendered. The element with the highest z-order is layered on top. Can use both positive and negative numbers.
visible bool If visible is True then the element is displayed, if False then the element will not display. Child-elements that the element owns will still be rendered. Defaults to True.
show bool If False then the element's child-elements will not be rendered to the screen. Defaults to True.
use_hover bool Defaults to True for some elements. Tells the GUI's listener object to listen for events from the current element:
onHover, onUnhover
use_click bool Defaults to True for some elements. Tells the GUI's listener object to listen for events from the current element:
onMousedown, onRightMousedown, onAnyMousedown, onMouseup, onRightMouseup, onAnyMouseup, onClick, onRightClick, onAnyClick, onBlur, onDeactivate

onActivate requires both use_click and use_active
onFocus requires both use_click and use_focus
use_scroll bool Defaults to True for some elements. Tells the GUI's listener object to listen for events from the current element:
onCenterMousedown, onCenterMouseup, onScrollUp, onScrollDown
use_active bool Defaults to True for some elements.
onActivate requires both use_click and use_active
use_focus bool Defaults to True for some elements.
onFocus requires both use_click and use_focus