* SAVER2.H - include file for generic state-saving and restoration facility
* By M. Asherman, Copyright (c) 1999, SpaceTime Systems
* 5/28/99: introduced to minimize hard-wired arbitrary constants.
* 10/18/99: adding macros related to new title, category, and notes config properties.
* 10/29/99: introduce new macros for field widths in savrpick.scx.
* 11/16/99: add macros for modes of the pick-a-config dialog, savrpick.scx.
* 8/3/00: adapted from old Saver.h for use with new SaverForm class (see task svma0010).
*	Adjusted for new Saver2 property and method naming conventions.
*	Introduced macros for error codes and messages used in Saver2's new SaverForm foundation class.
* 8/10/00: more error codes/messages for savrinit.prg (see task svma0015).
* 8/11/00: more error codes/messages for savrrest and savrsave.prg (svma0015).
* 11/6/00: adjusted for new Commander macro naming conventions (see cmma0004 and svma0029).
* 12/31/00: include errhandl.h to pick up its macros (needed by demoform.scx, at least).
* 1/3/01: introduce Saver-related trace level(s).
* 1/7-16/01: add macros for additional error cases (see task svma0013).
*	Also switch to convention of using negative error codes for generic Saver errors.
* 1/25/01: delete obsolete error code SV_EC_REST_CMDRDOFUNC, previously used for msg wrapping.
* 2/1/01: add macros for additional Destroy event error cases.
*
* Note that I didn't bother defining macros for arbitrary constants used
* only in the main saver demo program, since this is not intended to be incorporated
* into other applications.
*
* Reserve prefix "SV_" exclusively for Saver-related macros.

#include errhandl.h		&& ErHandler include file - for error codes and other macros
#include commandr.h		&& Commander include file - for error codes and other macros

* Macros for trace levels used in property ehp_tracelevel.
#define SV_TRACE_ALL 5		&& shorthand for turning on all Saver tracing (non-selectively)

* Macros related to generic title, category, and notes configuration properties
*
* Commander command-line prefixes used for state restoration commands on generic configuration properties
#define SV_CPCATEG CMDM_DLAS1 + 'm.cmdr_arg1.svp_category' + CMDM_DLAS2		&& Category 
#define SV_CPTITLE CMDM_DLAS1 + 'm.cmdr_arg1.svp_title' + CMDM_DLAS2		&& Title 
#define SV_CPNOTES CMDM_DLAS1 + 'm.cmdr_arg1.svp_notes' + CMDM_DLAS2		&& Notes 

* Commander sequence numbers used for state restoration commands on generic configuration properties
#define SV_CNCATEG 2	&& Seq # for Category restoration step
#define SV_CNTITLE 6	&& Seq # for Title restoration step
#define SV_CNNOTES 4	&& Seq # for Notes restoration step

* macros for field widths in dialog savrpick.scx
#define SV_FWCATEG 20		&& minimum width of Category column in listbox
#define SV_FWTITLE 80		&& minimum width of Title column in listbox
#define SV_FWIDTHS '70,70'	&& columnwidths property setting to be used for listbox

* modes of the pick-a-config dialog, passed as 3rd argument to savrpick.scx
#define SV_PMOCOPY "copy"		&& Copy... mode
#define SV_PMOSWIT "switch"		&& Switch To... mode (the default)

* macros for error codes and messages used in generic Saver2 classes and core UDFs
#define SV_EC_INIT_SAVEROBJ -501	&& error code
#define SV_EM_INIT_SAVEROBJ "First argument to savrinit() is not a Saver object reference."
#define SV_EC_INIT_FUNCEVAL -502	&& error code
#define SV_EM_INIT_FUNCEVAL "Unable to evaluate expression for default funcid: "
#define SV_EC_INIT_FUNCTYPE -503	&& error code
#define SV_EM_INIT_FUNCTYPE "Functionid argument must be of Character type.  Type is: "
#define SV_EC_INIT_CMDREVAL -504	&& error code
#define SV_EM_INIT_CMDREVAL "Unable to evaluate expression for default Commander: "
#define SV_EC_INIT_CMDRNEW -505		&& error code
#define SV_EM_INIT_CMDRNEW "Can't create Commander for state-saving meta-file: "
#define SV_EC_INIT_CMDRBAD -506		&& error code
#define SV_EM_INIT_CMDRBAD "No valid Commander object was supplied for state restoration."
#define SV_EC_REST_SAVEROBJ -511	&& error code
#define SV_EM_REST_SAVEROBJ "First argument to savrrest() is not a Saver object reference."
#define SV_EC_SAVE_SAVEROBJ -521	&& error code
#define SV_EM_SAVE_SAVEROBJ "First argument to savrsave() is not a Saver object reference."
#define SV_EC_GETL_NOPARENT -531	&& error code
#define SV_EM_GETL_NOPARENT "Parent Saver object reference argument is required."
#define SV_EC_GETL_NOTSUPP -532		&& error code
#define SV_EM_GETL_NOTSUPP "The SVM_GetLaunchCmd is not yet supported for non-form classes."
#define SV_EC_DEST_SAVE -541		&& error code
#define SV_EM_DEST_SAVE "Failed to automatically save configuration for funcid: "