Button and label widgets
The Common Widgets subsystem allows applications to create static text labels (CwLabel) and several types of buttons:
•Push buttons (CwPushButton)
•Cascade buttons (CwCascadeButton)
•On/off toggle buttons (CwToggleButton)
•Application-drawn buttons (CwDrawnButton)
The following resources define the visual appearance of labels and buttons: x, y, height, width, marginTop, marginBottom, marginHeight, marginWidth, marginLeft, and marginRight. These are illustrated in the following figure:
The marginTop, marginBottom, marginRight, and marginLeft resources are typically controlled by subclasses of CwLabel or by the label's parent. For example, a CwToggleButton could increase marginRight to make space for the toggle indicator. The marginHeight and marginWidth resources are usually left alone by subclasses, and can be manipulated by the application if desired.
Tip:
The margin resource settings indicate the preferred appearance of the widget. They might be ignored if they are not supported by the platform or conflict with the platform's look and feel.
By default, the name given in a label or button creation message is used as the widget's labelString. The contents of a label or button widget are changed using the labelString: resource method.
CwLabel provides accelerator and acceleratorText resources for adding an accelerator key to a toggle button or push button that is in a pop-up or pull-down menu. An accelerator key will activate a button at any time, provided the parent menu is managed. The accelerator resource is set to an instance of CwAccelerator created using the mask:keysym: class method, which takes the following arguments:
mask
The modifier key mask, which consists of a logical-OR of zero or more of the following: Mod1Mask, ControlMask, or ShiftMask.
keysym
The unmodified key, which must be a lowercase letter or special key, represented by a CwConstants 'XK' keysym value.
The acceleratorText resource describes the string that is displayed beside the button in the menu.
Note:
On some platforms, accelerators are case sensitive. A keysym value of XKn only fires with a lowercase accelerator key press.
Last modified date: 12/22/2017