Mnemonics "E" - Revision history

Justin at 22:53, 26 January 2026

2026-01-26T22:53:25Z

← Older revision		Revision as of 22:53, 26 January 2026
Line 35:		Line 35:
	*14 Right mouse click		*14 Right mouse click
	*15 Window caption bar "X" was clicked. '''See''' (CreateWindowEx).		*15 Window caption bar "X" was clicked. '''See''' (CreateWindowEx).
		+	*16 ?
		+	*17 X1 mouse click (usually side 'back' button)
		+	*18 X2 mouse click (usually side 'forward' button)
		+	*19 Mouse wheel scroll 'back'
		+	*20 Mouse wheel scroll 'forward'


Line 53:		Line 58:

	Value 15 was added in Comet2002 Build 306.		Value 15 was added in Comet2002 Build 306.
		+
		+	Values 17-20 were added in Comet 542.

	Example 1:		Example 1:
Line 78:		Line 85:
	IF VALUE = 14 ... ! Right mouse click		IF VALUE = 14 ... ! Right mouse click
	IF VALUE = 15 ... ! Window caption bar "X"		IF VALUE = 15 ... ! Window caption bar "X"
		+	IF VALUE = 17 ... ! X1 mouse click (usually side 'back' button)
		+	IF VALUE = 18 ... ! X2 mouse click (usually side 'forward' button)
		+	IF VALUE = 19 ... ! Mouse wheel scroll 'back'
		+	IF VALUE = 20 ... ! Mouse wheel scroll 'forward'
	.		.
	.		.

Brian: /* (Enable Close) */

2011-10-25T17:58:47Z

(Enable Close)

← Older revision		Revision as of 17:58, 25 October 2011
Line 188:		Line 188:
	Where:		Where:

-	Arg = 0 – Disable [X] on main view window (~~Displays~~ message: "Close has been disabled by the currently running program")	+	Arg = 0 – Disable [X] on main view window (If [X] is clicked the message: "Close has been disabled by the currently running program" will be displayed)

	Arg = 1 – Enable [X] on main view window if disable count reaches 0 (see discussion below)		Arg = 1 – Enable [X] on main view window if disable count reaches 0 (see discussion below)

Brian: /* (Enable Close) */

2011-10-25T17:57:28Z

(Enable Close)

← Older revision		Revision as of 17:57, 25 October 2011
Line 185:		Line 185:

	'''Mnemonic:''' (EnableClose = Arg)		'''Mnemonic:''' (EnableClose = Arg)
-
-	~~'''Discussion''': Enables or disables the [X] close button at the top of a main Comet Window. This mnemonic requires at minimum Comet build 451 and REL version 11.10.~~

	Where:		Where:
Line 192:		Line 190:
	Arg = 0 – Disable [X] on main view window (Displays message: "Close has been disabled by the currently running program")		Arg = 0 – Disable [X] on main view window (Displays message: "Close has been disabled by the currently running program")

-	Arg = 1 – Enable [X] on main view window if disable count reaches 0 (see ~~note~~ below)	+	Arg = 1 – Enable [X] on main view window if disable count reaches 0 (see discussion below)

	Arg = <anyothervalue> – Reset count and enable [X] on main view window		Arg = <anyothervalue> – Reset count and enable [X] on main view window

		+	'''Discussion''': Enables or disables the [X] close button at the top of a main Comet Window. Due to the possibility of nested programs calling this mnemonic, Comet will maintain a count of the number of “disables” issued. Only when the disable count reaches 0 will the close button be enabled. If a value other than 0 or 1 is issued then the disable count will be forced to 0 and the close button will be enabled. This mnemonic requires at minimum Comet build 451 and REL version 11.10.

-	~~Note: Due to the possibility of nested programs calling this mnemonic, Comet will maintain a count of the~~
-	number of “disables” issued. Only when the disable count reaches 0 will the close button be enabled. If a value other than 0 or 1 is issued then the disable count will be forced to 0 and the close button will be enabled.
-
-	~~This will work for C16 & C32~~
-
	'''Example:'''		'''Example:'''
	Print (EnableClose = 0) ! Disable [X] button while processing		Print (EnableClose = 0) ! Disable [X] button while processing

Brian: /* (Enable Close) */

2011-10-25T17:54:41Z

(Enable Close)

← Older revision		Revision as of 17:54, 25 October 2011
Line 186:		Line 186:
	'''Mnemonic:''' (EnableClose = Arg)		'''Mnemonic:''' (EnableClose = Arg)

-	'''Discussion''': Enables or disables the [X] close button at the top of a main Comet Window.	+	'''Discussion''': Enables or disables the [X] close button at the top of a main Comet Window. This mnemonic requires at minimum Comet build 451 and REL version 11.10.

	Where:		Where:
-	.Arg = 0 – Disable [X] on main view window (Displays message: "Close has been disabled by the currently running program")	+
-	.Arg = 1 – Enable [X] on main view window if disable count reaches 0 (see note below)	+	Arg = 0 – Disable [X] on main view window (Displays message: "Close has been disabled by the currently running program")
-	.Arg = <anyothervalue> – Reset count and enable [X] on main view window	+
		+	Arg = 1 – Enable [X] on main view window if disable count reaches 0 (see note below)
		+
		+	Arg = <anyothervalue> – Reset count and enable [X] on main view window
		+

-	Note: Due to the possibility of nested programs calling this mnemonic, Comet will maintain ~~the~~ count of the	+	Note: Due to the possibility of nested programs calling this mnemonic, Comet will maintain a count of the
-	number of “disables”. Only when the count reaches 0 will the close button be enabled. If a value other than	+	number of “disables” issued. Only when the disable count reaches 0 will the close button be enabled. If a value other than 0 or 1 is issued then the disable count will be forced to 0 and the close button will be enabled.
-	0 or 1 is ~~sent~~ then the ~~“disable”~~ count will be forced to 0 and the close button will be enabled.	+

	This will work for C16 & C32		This will work for C16 & C32
Line 205:		Line 208:
	.		.
	Print (EnableClose = 1) ! Done - Enable [X] button		Print (EnableClose = 1) ! Done - Enable [X] button
-
-

	== (End Metafile) ==		== (End Metafile) ==

Brian at 17:49, 25 October 2011

2011-10-25T17:49:06Z

← Older revision		Revision as of 17:49, 25 October 2011
Line 181:		Line 181:
	This example shows how to set normal mode, either at the beginning of a FORMAT statement or within a PRINT statement. <br>		This example shows how to set normal mode, either at the beginning of a FORMAT statement or within a PRINT statement. <br>
	The additional controls set background mode and display a heading at column 10, row 0.		The additional controls set background mode and display a heading at column 10, row 0.
		+
		+	== (Enable Close) ==
		+
		+	'''Mnemonic:''' (EnableClose = Arg)
		+
		+	'''Discussion''': Enables or disables the [X] close button at the top of a main Comet Window.
		+
		+	Where:
		+	.Arg = 0 – Disable [X] on main view window (Displays message: "Close has been disabled by the currently running program")
		+	.Arg = 1 – Enable [X] on main view window if disable count reaches 0 (see note below)
		+	.Arg = <anyothervalue> – Reset count and enable [X] on main view window
		+
		+	Note: Due to the possibility of nested programs calling this mnemonic, Comet will maintain the count of the
		+	number of “disables”. Only when the count reaches 0 will the close button be enabled. If a value other than
		+	0 or 1 is sent then the “disable” count will be forced to 0 and the close button will be enabled.
		+
		+	This will work for C16 & C32
		+
		+	'''Example:'''
		+	Print (EnableClose = 0) ! Disable [X] button while processing
		+	.
		+	. ! Perform uninterrupted processing
		+	.
		+	Print (EnableClose = 1) ! Done - Enable [X] button
		+
		+

	== (End Metafile) ==		== (End Metafile) ==

Barb at 15:04, 22 August 2011

2011-08-22T15:04:45Z

← Older revision		Revision as of 15:04, 22 August 2011
Line 281:		Line 281:
	\|Flag		\|Flag
	\|Description		\|Description
		+	\|-
		+	\|0
		+	\|Perform function on the server, CometAnywhere or not.
	\|-		\|-
	\|1		\|1
-	\|Perform function at CometAnywhere ~~remote system~~	+	\|Perform function on the client, CometAnywhere or not.
	\|-		\|-
	\|2		\|2
-	\|~~If not CometAnywhere, then substitute local~~ for ~~remote~~	+	\|Perform function for CometAnywhere only and perform it on the client.
	\|-		\|-
	\|}		\|}
-	~~If the program is running on a local Comet system (not on a CometAnywhere client system), this flag substitutes the local drive/path name for a remote path/drive name.~~

Badge: /* Execute Metafile */

2010-01-17T11:08:52Z

Execute Metafile

← Older revision		Revision as of 11:08, 17 January 2010
Line 389:		Line 389:

	== Execute Metafile ==		== Execute Metafile ==
-	~~<pre>~~	+
-	Mnemonic: (ExecuteMetafile = FileName)	+	'''Mnemonic:''' (ExecuteMetafile = FileName)
-	Discussion: Executes the previously saved metafile FileName.	+
-	~~</pre>~~	+	'''Discussion:''' Executes the previously saved metafile FileName.

Badge: /* (EraseFile) */

2010-01-17T11:08:13Z

(EraseFile)

← Older revision		Revision as of 11:08, 17 January 2010
Line 345:		Line 345:

	'''Suberror'''		'''Suberror'''
-	{\| Border=	+	{\| Border=1
	\|(FileError)		\|(FileError)
	\| Description		\| Description

Badge: /* (EraseFile) */

2010-01-17T11:07:29Z

(EraseFile)

← Older revision		Revision as of 11:07, 17 January 2010
Line 293:		Line 293:


-	After this mnemonic is issued, your program can issue an INPUT on LUN (0) to retrieve the error information. For example:	+	After this mnemonic is issued, your program can issue an INPUT on LUN (0) to retrieve the error information.
		+
		+	'''For example:'''

	LENGTH 2 & LOCAL AX$,DX$		LENGTH 2 & LOCAL AX$,DX$
Line 302:		Line 304:
	Print (EraseFile=File$,Flags)		Print (EraseFile=File$,Flags)
	Input (0,ResultFmt)		Input (0,ResultFmt)
-		+	.
-	The first field, AX$, contains the function error code, and the second field, DX$, contains the suberror code (aka the Windows file error code). Both of these fields are in Intel 2's complement format, and should be processed as follows:	+	The first field, AX$, contains the function error code, and the second field, DX$, contains the suberror code (aka the Windows file error code).
		+	Both of these fields are in Intel 2's complement format, and should be processed as follows:
	AX$ = SUB(AX$,2,1) + SUB(AX$,1,1) ! Flip the bytes around		AX$ = SUB(AX$,2,1) + SUB(AX$,1,1) ! Flip the bytes around
	DX$ = SUB(DX$,2,1) + SUB(DX$,1,1) ! Flip the bytes around		DX$ = SUB(DX$,2,1) + SUB(DX$,1,1) ! Flip the bytes around
	FuncError = HexDec(AX$) ! Function error code (decimal)		FuncError = HexDec(AX$) ! Function error code (decimal)
	FileError = HexDec(DX$) ! File error code (decimal)		FileError = HexDec(DX$) ! File error code (decimal)
-		+	.
	! For unexpected values, convert to 2's complement signed integer		! For unexpected values, convert to 2's complement signed integer
	If (FuncError > 32767) FuncError = FuncError-65536		If (FuncError > 32767) FuncError = FuncError-65536
Line 316:		Line 319:

	'''Error'''		'''Error'''
-	(FuncError) Description	+	{\| Border=1
-	0 Function not supported	+	\|(FuncError)
-	1 Success	+	\| Description
-	2 CometAnywhere required	+	\|-
-	3 Source file error (see suberrors)	+	\|0
-	4 Aborted by user	+	\| Function not supported
-	5 Function in progress	+	\|-
-		+	\|1
		+	\| Success
		+	\|-
		+	\|2
		+	\| CometAnywhere required
		+	\|-
		+	\|3
		+	\| Source file error (see suberrors)
		+	\|4
		+	\|Aborted by user
		+	\|-
		+	\|5
		+	\| Function in progress
		+	\|-
		+	\|}

	Here is a list of the suberror codes (common Windows file errors) in decimal form:		Here is a list of the suberror codes (common Windows file errors) in decimal form:

	'''Suberror'''		'''Suberror'''
-	(FileError) Description	+	{\| Border=
-	0 Success	+	\|(FileError)
-	2 File not found	+	\| Description
-	3 Path not found	+	\|-
-	5 Access denied	+	\|0
-	12 Invalid access	+	\| Success
-	15 Invalid drive	+	\|-
-	16 An error has occurred in the current directory	+	\|2
-	18 No more files	+	\| File not found
-	32 Sharing violation	+	\|-
-	33 Lock violation	+	\|3
-	80 File exists	+	\| Path not found
-	161 Bad pathname	+	\|-
-		+	\|5
-		+	\|Access denied
		+	\|-
		+	\|12
		+	\|Invalid access
		+	\|-
		+	\|15
		+	\|Invalid drive
		+	\|-
		+	\|16
		+	\|An error has occurred in the current directory
		+	\|-
		+	\|18
		+	\|No more files
		+	\|-
		+	\|32
		+	\|Sharing violation
		+	\|-
		+	\|33
		+	\|Lock violation
		+	\|-
		+	\|80
		+	\|File exists
		+	\|-
		+	\|161
		+	\|Bad pathname
		+	\|-
		+	\|}
	'''History:''' This mnemonic was added in Comet Build 299 and REL Version 01.07.		'''History:''' This mnemonic was added in Comet Build 299 and REL Version 01.07.

Badge: /* (EraseFile) */

2010-01-17T10:59:24Z

(EraseFile)

← Older revision		Revision as of 10:59, 17 January 2010
Line 288:		Line 288:
	\|If not CometAnywhere, then substitute local for remote		\|If not CometAnywhere, then substitute local for remote
	\|-		\|-
		+	\|}
	If the program is running on a local Comet system (not on a CometAnywhere client system), this flag substitutes the local drive/path name for a remote path/drive name.		If the program is running on a local Comet system (not on a CometAnywhere client system), this flag substitutes the local drive/path name for a remote path/drive name.