Kamaelia.UI.Pygame.Multiclick.Multiclick

class Multiclick(Axon.Component.component)

Multiclick(...) -> new Multiclick component.

Create a button widget in pygame, using the PygameDisplay service. Sends a message out of its outbox when clicked.

Keyword arguments (all optional): - caption -- text (default="Button <component id>") - position -- (x,y) position of top left corner in pixels - margin -- pixels margin between caption and button edge (default=8) - bgcolour -- (r,g,b) fill colour (default=(224,224,224)) - fgcolour -- (r,g,b) text colour (default=(0,0,0)) - msg -- sent when clicked (default=("CLICK",self.id)) of msgs is not specified - msgs -- list of messages. msgs[x] is sent when button X is clicked (default=None) - transparent -- draw background transparent if True (default=False) - size -- (width,height) pixels size of the button (default=scaled to fit caption)

Inboxes

• control : Shutdown messages: shutdownMicroprocess or producerFinished
• callback : Receive callbacks from PygameDisplay
• inbox : Receive events from PygameDisplay

Outboxes

• outbox : button click events emitted here
• signal : Shutdown signalling: shutdownMicroprocess or producerFinished

Methods defined here

__init__(self, caption, position, margin, bgcolour, fgcolour, msg, msgs, transparent, size)

x.__init__(...) initializes x; see x.__class__.__doc__ for signature

blitToSurface(self)

Clears the background and renders the text label onto the button surface.

buildCaption(self, text)

Pre-render the text to go on the button label.

main(self)

Main loop.

waitBox(self, boxname)

Generator. yields 1 until data ready on the named inbox.

---

Feedback

Got a problem with the documentation? Something unclear, could be clearer? Want to help with improving? Constructive criticism, preferably in the form of suggested rewording is very welcome.

Please leave the feedback here, in reply to the documentation thread in the Kamaelia blog.