|
TTASRadioButton |
  
|
|
TTASRadioButton |
|
Use this object to replace a standard Y/N question. If the user checks the box the value returned to the field attached to the object will be Y, if unchecked, it will return N. You can also make the attached field a type L (logical). In that case the object will return .True. (clicked) or .False. (unclicked) as would be expected. The major difference between this object and the TTASCheckBox is in usage. Generally, you would put two or more TTASRadioButton objects on a TGroupBox. The group box allows only one radio button to be chosen at a time. Using this, you can give the user multiple choices with the knowledge that they can only choose one.
PALETTE ICON & EXAMPLE
PROPERTIES
The following are the properties that apply to this object. Some are defined in Common Properties and are linked to their appropriate page.
Appearance
| Caption | This is the text that is displayed on the left or the right of the radio button depending on the value in Alignment. |
Behavior
Entry
Font
Hint
Misc
Other
| Checked | If the button is chosen this property will return .True. You can also preset the radio button by setting this value. |
Position
TAS Pro
| DfltValue | If you want to set the radio button use Y or N here. The default value is N. This can be changed during runtime. |
| FieldName | NOTE: if you use get_obj_prop() you must have a field name here if blank use can use. "NONE". |
NOTE : Also Pre post events will not fire without a FieldName or the word NONE here. (for both Pre and Post events) You must have a field name here, or if blank you can use "NONE"
| FldModified | NOTE: This is a runtime only property and will not show up in the Object Inspector. |
EVENTS
This object has events that are called depending on what the user does. The events are routines in your program that may return a value (generally .True. or .False.) or just alert your program that something is happening. An event looks to your program for a special label. It is made up of the object Name, a period (.) and the Event name (listed below). For example, the Click event below would be: ObjectName.Click:
| Change | This event is called every time the user clicks the button in this object. That includes entering a new character, deleting a character, etc. Each time this event is executed the field that is attached to this object through the FieldName property is updated so that you can check the new state through the field. Be cautious about using this since it will slow down the entry process. |
| Click | This event is called if the user clicks on the object. |
| Disp | This event is called when the field that is attached to the object is to be refreshed on the screen. This can happen when a record is read, after a calculation, etc. |
| Post | This event is called when the user moves from the current object to another. By default this event will return .True. If you return .False. This will keep the user from leaving this object. This will stop the process from continuing, This can be used to make sure settings are proper after leaving the object. To force the user to stay on the current object, if there is a problem, you may also use the Valid event instead of this. |
| Pre | This event is called when the user moves into an object. If you use this event you must return .True. or .False. when you return (RET) from the routine. If you return .True. the user is allowed to access the object. If you return .False. the object that was active before they got to this object will get the focus again. This keeps the user from accessing an object that you don't want to be active. Commonly used in application where some fields are accessible sometimes (RET .TRUE.) and aren't others (RET .FALSE.). |
The process by which these events are called is:
Pre - This occurs when focus changes to the object.
Change - During field entry.
Post - Called after Valid returns .True. (if there is a Valid event) and before the Pre for the next object.
Disp - Is called anytime the form/object is refreshed.
NOTE : Also Pre post events will not fire without a FieldName or the word NONE here. (for both Pre and Post events) You must have a field name here, or if blank you can use "NONE"
Page url: http://www.cassoftware.com/tas/manual/ttasradiobutton.htm