VCIsCurrentWorldValid

Version:

1.2

Description:

Verifies whether or not the currently set world is valid for displaying Visual CADD™ graphical information and if the world still exists.

Declaration:

C/C++

extern "C" vbool WINAPI VCIsCurrentWorldValid();

Delphi

function VCIsCurrentWorldValid:Wordbool; stdcall;

ActiveX/COM

Function IsCurrentWorldValid() As Integer

Parameters:

Returns - an integer value representing true or false.
0 is false.
1 is true.

Notes:

When a world is established it still can be closed out by the user. While Visual CADD™ does a good job of making sure the current world is valid, it is good practice to verify the validity of a world before trying to set it as current, as it may have been closed since its creation. Most Windows objects are not suitable viewing areas for graphics. VCIsCurrentWorldValid checks to see if the previously established object is valid or not and returns a true or false.