gui.isComponentValid

Checks the validity status of a GUI component.

Prototype

  1. bOk = gui.isComponentValid ( hComponent|sComponentIdentifier )

Description

gui.isComponentValid only determines if the hInstance that has been initialized before is still valid. It may have been destroyed between hInstance = gui.getComponent and this line. In this case, hInstance may not be nil but may be invalid. You might want to check both!

Parameters

hComponent|sComponentIdentifier - valid GUI component handle OR ID string

Return values

bOk - true if valid

Sample

  1. -- double check: nil and valid
  2. if ( hInstance and gui.isComponentValid ( hInstance ))

Available since ShiVa 2.0