Screensaver Extension for Visual DialogScript

Version: 1.7.30.2000
Copyright © 2000 PGWARE
All rights reserved


Description:
This is an extension for Visual DialogScript (32-bit version.) It adds a SCREENSAVER command and @SCREENSAVER function to the vocabulary of VDS. The dll allows users to easily create Screensavers in Visual DialogScript. The dll provides support for the windows screensaver password protection, enabling/disabling of keyboard keys, hiding/showing of the windows taskbar, hiding/showing of the mouse cursor, and support for the preview mode picture. Using Visual DialogScript alone users cannot create a fully functional screensaver, however now with this dll you can create screensavers that function and perform correctly. This extension is freeware for any type of usage. The dll comes with the source code so you can make modifications if you would like to. The source code was compiled in Borland Delphi 5. Please drop by PGWARE.COM and purchase some of our products in appreciation of this free extension.

Commands:
[+] SCREENSAVER CAPTURE,<filename>
[+] SCREENSAVER DISABLEKEYS
[+] SCREENSAVER ENABLEKEYS
[+] SCREENSAVER HIDECURSOR
[+] SCREENSAVER HIDETASKBAR
[+] SCREENSAVER PASSWORD,<%2>
[+] SCREENSAVER PREVIEW,<%2>,<filename>
[+] SCREENSAVER SHOWCURSOR
[+] SCREENSAVER SHOWTASKBAR


[ Command Explanation ] :

[-] SCREENSAVER CAPTURE,<filename>

This command captures the entire screen as a screenshot and saves the image as a file. The screenshot will be saved as a standard Windows bitmap file. This can be used to simulate placing objects ontop of the current desktop, such as a bouncing ball rolling over windows already opened.

<filename> - this is the filename to save the screenshot to. This must be a valid path and saved as a bmp file. For example: SCREENSAVER CAPTURE,c:\windows\desktop\shot1.bmp



[-] SCREENSAVER DISABLEKEYS

This command disables shortcut keys such as (CTRL+ALT+DEL);(ALT+TAB) and the Windows keyboard button. This is important so a user cannot prematurely close and break out of a screensaver that is used to lock a desktop from improper access.



[-] SCREENSAVER ENABLEKEYS

This command enables shortcut keys such as (CTRL+ALT+DEL);(ALT+TAB) and the Windows keyboard button that have been disabled by the SCREENSAVER DISABLE commmand. This should be used right before the screensaver is closed.



[-] SCREENSAVER HIDECURSOR

This command hides the mouse pointer/cursor. This should be used while the screensaver is visible.



[-] SCREENSAVER HIDETASKBAR

This command hides the Windows taskbar. This should be used while the screensaver is visible.



[-] SCREENSAVER PASSWORD,<%2>

This command shows the windows screensaver password configuration dialog. This command should only be used after receiving the ( '/A', '-A', or 'A') as the first commandline parameter %1 from the Windows screensaver properties window.

<%2> - the variable %2 must be supplied as it holds the windows classname of the Windows screensaver properties window, the purpose of this is to center the password configuration dialog with the properties window.



[-] SCREENSAVER PREVIEW,<%2>,<filename>

This command sets the screensaver preview mode picture to a valid bitmap image. This command should only be used after receiving the ( '/P', '-P', or 'P') as the first commandline parameter from the Windows screensaver properties window.

<%2> - the variable %2 must be supplied as it holds the windows classname of the Windows screensaver properties window, the purpose of this is to place a valid bitmap image within the preview container.
<filename> - this should be either a path to a bitmap (.bmp) file. for ex.

SCREENSAVER PREVIEW,%2,c:\windows\desktop\preview.bmp

Or to a standard Visual DialogScript resource file. To load a resource you must supply the filename and its byte offset seperated by the | character. for ex:

SCREENSAVER PREVIEW,%2,c:\windows\desktop\images.dsr|232

Where images.dsr is the standard Visual DialogScript resource file and a seperator | is used to seperate the offset of 232 bytes. This format must be used or the system or your screensaver may crash.



[-] SCREENSAVER SHOWCURSOR

This command shows the mouse pointer/cursor. This should be used right before the screensaver is closed.



[-] SCREENSAVER SHOWTASKBAR

This command shows the Windows taskbar. This should be used right before the screensaver is closed.



Functions:
[+] @SCREENSAVER(PASSWORD,<screensaver title>)
[+] @SCREENSAVER(KEYDOW)


[ Function Explanation ] :

[-] @SCREENSAVER(PASSWORD,<screensaver title>)

This function will display the Windows screensaver password entry dialogbox if a password is required to exit the screensaver and then returns either a true/false value indicating whether the password entered is valid.

<screensaver title> - this parameter is the screensavers title name. This is required so the password entry dialogbox is centered in the middle of the screensaver window.

return value(s):
   0 - password entered is incorrect
   1 - password entered is correct



[-] @SCREENSAVER(KEYDOWN)

This function returns a true/false value indicating whether any keyboard keys have been pressed down.

return value(s):
   0 - the keyboard has not been pressed
   1 - the keyboard has been pressed




Support:
Please note that since this is a freeware product, support is not provided. However bug fixes will be made as they are found. Report bugs to [ support@vdsworld.com ].



Contributions:
Tommy Sools: A major portion of this extension's source code was provided by Tommy Sools.
Julian Moss: For providing the documentation on the structure of standard visual dialogscript resource files.



Copyright © 2000 PGWARE / All rights reserved.