83PCE:Hooks:D02608 - Revision history

PT: /* Examples */

2016-09-20T22:21:59Z

‎Examples

PT at 08:43, 10 August 2016

2016-08-10T08:43:36Z

PT at 09:29, 9 August 2016

2016-08-09T09:29:16Z

PT: /* Examples */

2016-07-18T18:25:45Z

‎Examples

PT at 18:18, 18 July 2016

2016-07-18T18:18:50Z

PT at 18:17, 18 July 2016

2016-07-18T18:17:59Z

PT at 16:40, 18 July 2016

2016-07-18T16:40:57Z

PT at 15:43, 18 July 2016

2016-07-18T15:43:44Z

PT: Created page with "Menu Hook D02608 - Menu Hook Coming soon..."

2016-07-18T15:41:22Z

Created page with "Menu Hook D02608 - Menu Hook Coming soon..."

New page

[[Category:83PCE:Hooks:By_Name|Menu Hook]] [[Category:83PCE:Hooks:By_Address|D02608 - Menu Hook]]
Coming soon...

@@ Line 63: / Line 63: @@
 	db 0,kZOut	;these are 2-byte keypresses of each entry</nowiki>
-'''Note:'''
+'''Notes:'''
-you can find the string table entry for strings here: http://wikiti.brandonw.net/index.php?title=83Plus:Hooks:9BCC#Condition_7

← Older revision		Revision as of 08:43, 10 August 2016
Line 62:		Line 62:
	db 0,kZIn ;second header		db 0,kZIn ;second header
	db 0,kZOut ;these are 2-byte keypresses of each entry</nowiki>		db 0,kZOut ;these are 2-byte keypresses of each entry</nowiki>
		+
		+	'''Note:'''
		+	you can find the string table entry for strings here: http://wikiti.brandonw.net/index.php?title=83Plus:Hooks:9BCC#Condition_7

@@ Line 23: / Line 23: @@
 '''Before the menu is displayed'''
 * '''A=4''': this is the first event called. '''B''' contains the value of the menu about to be displayed. [[84PCE:RAM:D00824|MenuCurrent]] contains the value of the previous menu that was displayed. Return ''nz'' to cancel the displaying. Edit '''B''' to the menu you want to be displayed.
-* '''A=0''': this is called BEFORE the header will be drawn. It is called twice:
+* '''A=0''': this is called BEFORE the header will be drawn. This is the moment to provide your own table. Point '''hl''' to it, and return ''nz''. You can also change menuCurrent and return z, to display another OS menu. An example of how a table would look like, can be found at the bottom of this page. If you still want to display an OS menu, return ''z'', as normal. It is called twice:
 ** First time: '''B''' = the value of the menu.
-** Second time: '''B''' = 0. This is the moment to provide your own table. Point '''hl''' to it, and return ''nz''. You can also change menuCurrent and return z, to display another OS menu. An example of how a table would look like, can be found at the bottom of this page. If you still want to display an OS menu, return ''z'', as normal.
+** Second time: '''B''' = 0.
 * '''A=2''': This event is called before the OS draws (one of the) header(s). '''C''' is the header index, starting with 0. Return ''nz'' to ignore the drawing. Note: the OS will still display the padding space, so it looks a bit weird.
 * '''A=0''': the hook is again called when all the headers are drawn. '''A''' is equal to 0, and '''C''' is the number of headers (basically, last index + 1). Return ''nz'' to mess up your calc. I can't guarentee what will happen. Returning ''z'' will display the right menu.

@@ Line 54: / Line 54: @@
 	db 2		;how many headers?
 	db 3 	;how many choices under 1st header?
-	db 2 	;how many choices under 1st header?
+	db 2 	;how many choices under 2nd header?
 	db 5Eh	;string table entry for "ZOOM"
 	db 5Fh  ;just for fun

@@ Line 26: / Line 26: @@
 ** First time: '''B''' = the value of the menu.
 ** Second time: '''B''' = 0. This is the moment to provide your own table. Point '''hl''' to it, and return ''nz''. You can also change menuCurrent and return z, to display another OS menu. An example of how a table would look like, can be found at the bottom of this page. If you still want to display an OS menu, return ''z'', as normal.
-* '''A=2''': This event is called before the OS draws (one of the) header(s). '''C''' is the header index, starting at 0. Return ''nz'' to ignore the drawing. Note: the OS will still display the padding space, so it looks a bit weird.
+* '''A=2''': This event is called before the OS draws (one of the) header(s). '''C''' is the header index, starting with 0. Return ''nz'' to ignore the drawing. Note: the OS will still display the padding space, so it looks a bit weird.
 * '''A=0''': the hook is again called when all the headers are drawn. '''A''' is equal to 0, and '''C''' is the number of headers (basically, last index + 1). Return ''nz'' to mess up your calc. I can't guarentee what will happen. Returning ''z'' will display the right menu.
 * '''A=1''': The OS is about to draw one of the options. The number prefix has already been drawn. Return ''nz'' to ignore the drawing, it will only 'draw' an empty line. Otherwise, it will just display the right option.
@@ Line 37: / Line 37: @@
 '''The user has selected an item'''
-* '''A=0''': '''C''' contains the selected item, started with 0. It seems that B is equal to C.
+* '''A=0''': '''C''' contains the selected item, starting with 0. It seems that B is equal to C.
 * '''A=3''': Return ''nz'' to cancel this, and leave the menu open.

@@ Line 19: / Line 19: @@
 I've ordered the events in the order that they are called by the OS.
 '''Before the menu is displayed'''
-* '''A=4''': this is the first event called. '''B''' contains the value of the menu about to be displayed. MenuCurrent contains the value of the previous menu that was displayed. Return ''nz'' to cancel the displaying. Edit '''B''' to the menu you want to be displayed.
+* '''A=4''': this is the first event called. '''B''' contains the value of the menu about to be displayed. [[84PCE:RAM:D00824|MenuCurrent]] contains the value of the previous menu that was displayed. Return ''nz'' to cancel the displaying. Edit '''B''' to the menu you want to be displayed.

← Older revision		Revision as of 16:40, 18 July 2016
Line 12:		Line 12:

	'''Hook Active Flag:''' [[83Plus:Flags:36#Bit_6\|6, (iy + 36h)]]		'''Hook Active Flag:''' [[83Plus:Flags:36#Bit_6\|6, (iy + 36h)]]
		+
		+	The menu hook allows for modification of any of the system menus that are presented through the system monitor.
		+
		+	== Using the Hook ==
		+	This hook, like most, is called for several events, each identified by A. In general, it appears that returning with the zero flag set will cause the OS to execute its normal behavior.
		+
		+	I've ordered the events in the order that they are called by the OS.
		+
		+	'''Before the menu is displayed'''
		+	* '''A=4''': this is the first event called. '''B''' contains the value of the menu about to be displayed. MenuCurrent contains the value of the previous menu that was displayed. Return ''nz'' to cancel the displaying. Edit '''B''' to the menu you want to be displayed.

← Older revision		Revision as of 15:43, 18 July 2016
Line 1:		Line 1:
	[[Category:83PCE:Hooks:By_Name\|Menu Hook]] [[Category:83PCE:Hooks:By_Address\|D02608 - Menu Hook]]		[[Category:83PCE:Hooks:By_Name\|Menu Hook]] [[Category:83PCE:Hooks:By_Address\|D02608 - Menu Hook]]
−	~~Coming soon...~~	+	== Synopsis ==
		+	'''Name:''' Menu Hook
		+
		+	'''Hook Pointer Block Address:''' D02608
		+
		+	'''Hook Enable BCALL:''' 021518
		+
		+	'''Hook Disable BCALL:''' 02151C
		+
		+	'''Hook Call BCALL:''' ''(none known)''
		+
		+	'''Hook Active Flag:''' [[83Plus:Flags:36#Bit_6\|6, (iy + 36h)]]