Specifies whether the whole object or any of its parts is currently visible on screen.
|TestObj||A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section|
All onscreen objects.
To view this property in the Object Browser panel and in other panels and dialogs, activate the Advanced view mode.
True if any part of the object is currently visible on screen, otherwise False.
VisibleOnScreen property returns
true, if a control or its part is on screen and can accept mouse clicks. For example, focused controls whose opacity is set to 0 are absolutely transparent (that is, invisible), but their
VisibleOnScreen property will return
VisibleOnScreen property is always
false for disabled Silverlight controls.
The Name Mapping repository of your project uses various object properties to identify objects in your tested application. We do not recommend that you use
VisibleOnScreen as an object identification property. It can take much time for TestComplete to get the property value that can significantly decrease your test performance, especially if the Extended Find is used.
For the same reason, we do not recommend that you use the
VisibleOnScreen property in search criteria of the
FindAllChildren methods. TestComplete will have to get the value of this property of every object it checks when calling the methods that can decrease your test performance.
To view an example that demonstrates how to use the
VisibleOnScreen property, see Waiting for an Object, Process or Window Activation.