Parent pronoun
Description
Parent in a PowerBuilder script refers
to the object that contains the current object.
Usage
You can use the pronoun Parent in scripts
for:
-
Controls in windows
-
Custom user objects
-
Menus
Where you use Parent determines what it
references:
Window controls
When you use Parent in a script for a control
(such as a CommandButton), Parent refers to the
window that contains the control.
User object controls
When you use Parent in a script for a control
in a custom user object, Parent refers to the
user object.
Menus
When you use Parent in a menu script, Parent refers
to the menu item on the level above the menu the script is for.
Examples
Window controls
If you include this statement in the script for the Clicked event
in a CommandButton within a window, clicking the button closes the window
containing the button:
|
1 |
Close(Parent) |
If you include this statement in the script for the CommandButton,
clicking the button displays a horizontal scroll bar within the
window (sets the HScrollBar property of the window to true):
|
1 |
Parent.HScrollBar = TRUE |
User object controls
If you include this statement in a script for the Clicked event
for a CheckBox in a user object, clicking the check box hides the
user object:
|
1 |
Parent.Hide( ) |
If you include this statement in the script for the CheckBox,
clicking the check box disables the user object (sets the Enabled
property of the user object to false):
|
1 |
Parent.Enabled = FALSE |
Menus
If you include this statement in the script for the Clicked
event in the menu item Select All under the menu item Select, clicking
Select All disables the menu item Select:
|
1 |
Parent.Disable( ) |
If you include this statement in the script for the Clicked
event in the menu item Select All, clicking Select All checks the
menu item Select:
|
1 |
Parent.Checked = TRUE |