Description
Obtains the parent of the specified object.
Applies to
Any object
Syntax
objectname.GetParent ( )
|
Argument |
Description |
|---|---|
|
objectname |
A control in a window or user object or an item on a menu for which you want the parent object |
Return value
PowerObject. Returns a reference to the parent of objectname.
Examples
In event scripts for a user object that will be used as a tab page, you can use code like the following to make references to the parent Tab control generic:
// a_tab is generic; // it does not know about specific pages tab a_tab // a_tab_page is generic; // it does not know about specific controls userobject a_tab_page // Get values for the Tab control and the tab page a_tab = this.GetParent( ) // Somewhat redundant, for illustration only a_tab_page = this // Set properties for the tab page a_tab_page.PowerTipText = "Important property page" // Set properties for the Tab control a_tab.PowerTips = TRUE // Run Tab control functions a_tab.SelectTab(a_tab_page)
You cannot refer to controls on the user object because a_tab_page does not know about them. You cannot refer to specific pages in the Tab control because a_tab does not know about them either.
In event scripts for controls on the tab page user object, you can use two levels of GetParent to refer to the user object and the Tab control containing the user object as a tab page:
// For a control, add one more level of GetParent() // and you can make the same settings as above tab a_tab userobject a_tab_page a_tab_page = this.GetParent() a_tab = a_tab_page.GetParent() a_tab_page.PowerTipText = "Important property page" a_tab.PowerTips = TRUE a_tab.SelectTab(a_tab_page)
See also
