Progress
ADM 2 Reference
hideObject (smart.p)
Hides the current object if it is a visual object and sets the ObjectHidden property to true to indicate the state of the object.
Parameters: NoneReturns: Nothing (procedure)Notes:
- The
“
Hide”
concept is a logical one here; nonvisual objects might also be“
hidden”
, meaning that they are not currently active; this might affect whether code in some event procedures is executed. For example, SmartDataObjects will not respond to events such as fetchNext and fetchLast if they are logically“
hidden”
, even though they have no visualization. This allows certain SmartLinks to be effectively deactivated when the object at one end or the other is hidden.- When a SmartContainer is hidden, it is not necessary for all of the objects it contains to be individually hidden because they will be hidden along with the container. For this reason, hideObject, when executed for a SmartContainer, will set the property ContainerHidden in each contained SmartObject without actually running hideObject in each object. The setContainerHidden function will, in turn, set the ObjectHidden property to TRUE so that it can be queried successfully. Not running hideObject in each individual SmartObject improves performance when SmartObjects are being paged (alternately hidden and viewed), and can eliminate problems with
“f
lashing”
of visual objects or problems restoring proper frame order when objects are hidden and viewed.- The hideObject procedure can be localized when behavior in addition to the default is needed when a SmartObject is hidden, for example to decide whether a hidden component should actually be destroyed to conserve memory.
Examples:
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |