//----------------------------------------//
//                                        //
//  PDE Desktop Environment (OS/2)        //
//  http://os2progg.by.ru/pde             //
//                                        //
//  PDE common dialogs DLL (PDEEDLGS.DLL) //
//  TECHNICAL INFORMATION                 //
//  Copyleft [PDE Team] 2004              //
//                                        //
//  Programmers:                          //
//  stVova                                //
//                                        //
//----------------------------------------//

Information about "PDEDLGS.DLL" version 1. This library is supplied with
PDE v.0.20.

This quick page describe functions, that exported by "PDEDLGS.DLL".

NOTE: All notations given in Pascal. But this DLL can be used in other 
programming languages (C, C++, Basic, REXX etc.).

NOTE: "PDEDLGS.DLL" v.1 require PDE v.0.20 to work propertly 
(not required running PDE, but installed on HDD and in "CONFIG.SYS" 
must be present "PDE_HOME" variable).
You can check, if PDE installed on PC by quering "PDE_HOME".
____________________________________________

All functions are exported by indexes

INDEXES NAMES
____________________________________________

1	function DllVer: Integer;
Return "PDEDLGS.DLL" module version. Use it to know, what version of module is
present. Modules with different versions may export different functions.

2	function pdeMessageBoxOK(text, cptn: String; bmp: hpointer): Integer;
Show the dialog box with Caption, Text, Bitmap/Icon image (40x40) and "OK"
button.
NOTE: HPOINTER = INTEGER

3	function pdeMessageBox(text, cptn: String; bmp: hpointer): Integer;
Show the dialog box with Caption, Text, Bitmap/Icon image and "OK/CANCEL"
buttons. If user choose "OK", function returns "0", else "1".

4	function pdePromptDialog(text, cptn, default: String): String;
Show dialog, asking useer to input some string. As default answer use "default"

5	function pdeColorDialog(var Color: TColor): Boolean;
Color choosing dialog. Return choosed color in "Color".
NOTE: TCOLOR = LONGINT

6	function pdeCopyDialog(src, text: String): String;
Dialog for choosing target directory in Copy/Move operations.
Returns full path+name to the result file.

7	function pdeOpenFileDialog(cptn, directory, mask: String): String;
Cool file open and save dialog. Also can be used to choose directory.
NOTE: for now can choose only one file
      mask example: mask = 'All (*.*)|Exe (*.exe;*.com;*.cmd;*.bat)|'

8	function pdeAboutDialogS(about, authors, thanks, cptn, text, license: String; logo: LongInt): Integer;

9	function LoginDlg(user, pass: String; reboot, shutdown: Boolean): Integer;
Cool dialog for login.

10	procedure ShowProgressS(text: String; interval: Integer);
Simple display window with text "text" and wait "inteerval" seconds

11	function pdeChooseDirDialog(cptn, text: String): String;
Cool dialog to choose directory. Return directory path (example: "C:\pde")

12	function pdeAuthorizationManager: Integer;
This dialog allow user to config usernamee and password. Changes automatically
will written into "pswd.cfg".

13	function pdeListDialog(cptn, text: String; lst: array of String): String;
Show dialog with list of strings and OK button. Returns selected string.

14	function RunDialogS(cptn, text: String; img: LongInt): String;
Show "Run..." dialog, that allow to choose program/folder and return it
to calling. Don't executing selected.

15	function RunDialogR(cptn, text: String; img: LongInt): String;
Same as previous, but execute selected by itself (using ShellExecute()).

16	function pdeShutdownDlg: Integer;
Show "shutdown system" dialog and perform selected action, using "seetboot.exe"
and APM/2.

18      procedure pdeDiskFree;
This is pDisksFree utility of PDE.

50	function ShellExecuteS(fname, fdir, fparam: string): LongInt;
Simplest wrapper for DosStartSession() API function.
NOTE: If "fparam" not empty always add "" ('"'+fparam+'"').

51	function ShellExecute(fname, fdir, fparam: string; shortcut: boolean): LongInt;
NOTE: if "shortcut" parameter is "true", then "fparam" will not be in ""

52	function _ShellExecute(fname, fdir, fparam: string; shortcut: boolean; fg, pgmCntr, rel: LongWord): LongInt;
This is wrapper for DosStartSession() API function
NOTE: fg 	= ssf_Fgbg_Fore/ssf_Fgbg_Back
      pgmCntr 	= ssf_Control_Visible/SSF_CONTROL_INVISIBLE etc
      rel 	= ssf_Related_Independent/SSF_RELATED_CHILD

53	procedure APMShutdown(req: String);
Invoke APM/2 (if present), overwise - generic 'shutdown.exe'
NOTE: req = suspend/standby/any_to_turn_off

54      function PDEFolder: String;
Return PDE_HOME variable from "CONFIG.SYS" or "c:\pde"

100 procedure ShowSaper;
This is "pMine" game of PDE.

101 procedure AlarmClock;
This is "Alarm clock" utility of PDE.

____________________________________________
22/03/2004 - 15/08/2004