class CPushButton
__init__(self, parent, text)

CCheckButton
__init__(self, parent, text)

CRadioButton
__init__(self, parent, text, group = None)


These classes represent buttons, a control the user can press with the
mouse.  A push button is a plain button.  A check button shows a check
mark to the left of its text, and can be checked or unchecked.  A radio
button is like a check button, but exists in a group of other radio
buttons.  Exactly one of the group of radio buttons is checked and all
others are unchecked.  The first radio button constructed is the head
of the group.

All buttons have a text name to display on the button.  They also have
a "handler" name, the name of a method which will be called when the button
is pressed.  The handler name is equal to the alphanumeric characters in the
button text prepended with "OnButton" when the button is constructed, but the
handler name may be changed to any string.  When the button is pressed a command
message is generated which is routed among the objects in the program (see messages)
until a method with the handler name is found.  The form of a button message
handler is "OnButtonQuit(self, control)" where "Quit" is the button text, "self" is
the object defining the handler method, and "control" is the button object which
generated the message.

All buttons maintain their own check marks.  You do not need to write code to check
or unckeck buttons in response to user actions.  Instead you write the handler
methods to react to button presses, and you read the checked/unchecked state
of a button from the instance variables.

Instance Variables

wpyParent, wpyText, wpyChildList, wpySizeX/Y, wpyLocX/Y, wpyAnchor

wpyCheckValue, int zero or one, readonly after Create(), CCheckButton only
	Used only by CCheckButton, this variable is zero or one to indicate
	whether the button is checked.  This can be assigned a value 0 or 1
	when the button is constructed, but is a read-only variable after the
	button is created.  Check and radio buttons maintain their own checks
	in response to user actions.

wpyRadioSelected, CRadioButton object, readonly, CRadioButton only
	For each radio button, this is the selected radio button, the one with
	the check.

wpyGroup, CRadioButton object, readonly, CRadioButton only
	For each radio button, this is the button which is the head of the group.
	The radio button constructed first has "group" None in its __init__ call,
	and this makes it the head button.  Subsequent radio buttons in the same
	group have "group" equal to the head button.

wpyGroupList, list of CRadioButtons, readonly, CRadioButton group button only
	For the radio button which is the head of the group, this is a list
	of all the radio buttons in the group.

Methods

EnableWindow(bool), ShowWindow(bool), geometry

__init__(self, parent, text)
	Return a button with self.wpySizeX/Y set according to the arguments given.
__init__(self, parent, text, group = None)
	Return a radio button as a member of the specified group, and with
	self.wpySizeX/Y set according to the arguments given.
parent, object
	The view or dialog parent of the control.
text, string
	The text to display in the button.  Assigned to wpyText.
group, a CRadioButton object or None
	For radio buttons, construct the button as a member of group "group".  The
	first radio button has "group" equal to None, subsequent buttons have "group"
	equal to the first button.

Create(self)
	Make the button visible by calling the underlying GUI.

SetCheck(self, check = 1)
	Set or unset the checked state of a check button or radio button.  For
	a check button, "check" must be 0 or 1 to uncheck or check the button.
	For a radio button, "check" must be 1 to select the given button
	and unselect all other buttons (0 is not allowed).

WpyCommandRouter(self)
	Simulate a button press message.

Examples

# Create a push button, a check button and three radio buttons.
p  = CPushButton(parent, "Quit").Create()
c  = CCheckButton(parent, "Status bar").Create()
r1 = CRadioButton(parent, "Times")
r2 = CRadioButton(parent, "Garamond", r1)
r3 = CRadioButton(parent, "Helvetica", r1)

# Create a handler for a button press as a method of another object.
class MyView(CScrollView):
  def OnButtonQuit(self, control):
    pass	# self is the view object, control is the button object