Intuition Mouse - Revision history

Costel Mincea: Text replacement - "" to ""

2025-01-26T19:10:15Z

Text replacement - "<syntaxhighlight>" to "<syntaxhighlight lang="C" line>"

← Older revision		Revision as of 19:10, 26 January 2025
Line 92:		Line 92:
	The example program below shows the use of IDCMP_MOUSEBUTTONS, IDCMP_MOUSEMOVE and DoubleClick(). DoubleClick() is used to test the interval between two times and determine if the interval is within the user specified time for double clicking as set in the Preferences Input editor.		The example program below shows the use of IDCMP_MOUSEBUTTONS, IDCMP_MOUSEMOVE and DoubleClick(). DoubleClick() is used to test the interval between two times and determine if the interval is within the user specified time for double clicking as set in the Preferences Input editor.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	BOOL DoubleClick( ULONG sSeconds, ULONG sMicros,		BOOL DoubleClick( ULONG sSeconds, ULONG sMicros,
	ULONG cSeconds, ULONG cMicros );		ULONG cSeconds, ULONG cMicros );
Line 101:		Line 101:
	DoubleClick() returns TRUE if the time interval was short enough to qualify as a double-click. A FALSE return indicates that the time interval between presses took too long. The button presses should be treated as separate events in that case.		DoubleClick() returns TRUE if the time interval was short enough to qualify as a double-click. A FALSE return indicates that the time interval between presses took too long. The button presses should be treated as separate events in that case.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	/*		/*
	** mousetest.c - Read position and button events from the mouse.		** mousetest.c - Read position and button events from the mouse.

Steven Solie: /* Mouse Messages */

2015-10-30T22:17:35Z

Mouse Messages

← Older revision		Revision as of 22:17, 30 October 2015
Line 72:		Line 72:
	= Mouse Messages =		= Mouse Messages =

	Mouse events are broadcast to the application via the IDCMP or the console device. See ~~the "~~Intuition Input and Output Methods~~" chapter in this book~~ for information on the IDCMP. See the [[Console_Device\|Console Device]] for more about the console device.		Mouse events are broadcast to the application via the IDCMP or the console device. See [[Intuition_Input_and_Output_Methods\|Intuition Input and Output Methods]] for information on the IDCMP. See the [[Console_Device\|Console Device]] for more about the console device.

	Simple mouse button activity not associated with any Intuition function will be reported to the window as an IntuiMessage with a Class of IDCMP_MOUSEBUTTONS. The IntuiMessage Code field will be set to SELECTDOWN, SELECTUP, MIDDLEDOWN, MIDDLEUP, MENUDOWN or MENUUP to specify changes in the state of the left, middle and right buttons, respectively.		Simple mouse button activity not associated with any Intuition function will be reported to the window as an IntuiMessage with a Class of IDCMP_MOUSEBUTTONS. The IntuiMessage Code field will be set to SELECTDOWN, SELECTUP, MIDDLEDOWN, MIDDLEUP, MENUDOWN or MENUUP to specify changes in the state of the left, middle and right buttons, respectively.
Line 78:		Line 78:
	Direct select button events will not be received by the program if the select button is pressed while the pointer is positioned over a gadget or other object which uses the button event. For example, select button activity over a gadget is reported with a Class of IDCMP_GADGETDOWN or IDCMP_GADGETUP. The gadget is said to have ''consumed'' the mouse events and ''produced'' gadget events.		Direct select button events will not be received by the program if the select button is pressed while the pointer is positioned over a gadget or other object which uses the button event. For example, select button activity over a gadget is reported with a Class of IDCMP_GADGETDOWN or IDCMP_GADGETUP. The gadget is said to have ''consumed'' the mouse events and ''produced'' gadget events.

	If the menu system is enabled, menu selections appear with a Class of IDCMP_MENUPICK. To directly receive menu button events, the application must set the flag WFLG_RMBTRAP for the window either when the window is opened or by changing the flag in a single, atomic operation. See ~~the chapter "~~Intuition Windows" for more information on the flag WFLG_RMBTRAP.		If the menu system is enabled, menu selections appear with a Class of IDCMP_MENUPICK. To directly receive menu button events, the application must set the flag WFLG_RMBTRAP for the window either when the window is opened or by changing the flag in a single, atomic operation. See [[Intuition_Windows\|Intuition Windows]] for more information on the flag WFLG_RMBTRAP.

	The program receives mouse position changes in the event Class IDCMP_MOUSEMOVE. The MouseX and MouseY position coordinates describe the position of the mouse relative to the upper left corner of the reference window. These coordinates are always in the resolution of the screen being used, and may represent any pixel position on the screen, even though the hardware sprites can be positioned only on the even numbered pixels of a high resolution screen and on the even numbered rows of an interlaced screen. Enabling IDCMP_MOUSEMOVE messages is discussed below in the section on "The Pointer".		The program receives mouse position changes in the event Class IDCMP_MOUSEMOVE. The MouseX and MouseY position coordinates describe the position of the mouse relative to the upper left corner of the reference window. These coordinates are always in the resolution of the screen being used, and may represent any pixel position on the screen, even though the hardware sprites can be positioned only on the even numbered pixels of a high resolution screen and on the even numbered rows of an interlaced screen. Enabling IDCMP_MOUSEMOVE messages is discussed below in the section on "The Pointer".

Steven Solie at 22:15, 30 October 2015

2015-10-30T22:15:14Z

← Older revision		Revision as of 22:15, 30 October 2015
Line 1:		Line 1:
	{{WIP}}
	= Intuition Mouse =		= Intuition Mouse =

Steven Solie at 21:45, 8 April 2014

2014-04-08T21:45:56Z

← Older revision		Revision as of 21:45, 8 April 2014
Line 339:		Line 339:
	= Function Reference =		= Function Reference =

	The following are brief descriptions of the Intuition functions that relate to the use of the mouse ~~and keyboard~~ under Intuition. See the SDK for details on each function call.		The following are brief descriptions of the Intuition functions that relate to the use of the mouse under Intuition. See the SDK for details on each function call.

	{\| class="wikitable"		{\| class="wikitable"
Line 347:		Line 347:
	\| DoubleClick()		\| DoubleClick()
	\| Test two time values for double click status.		\| Test two time values for double click status.
	\|-
	\| SetPointer()
	\| Change the Intuition pointer imagery for an open window.
	\|-
	\| ClearPointer()
	\| Restore the default Intuition pointer imagery.
	\|-		\|-
	\| SetMouseQueue()		\| SetMouseQueue()

Steven Solie at 21:40, 8 April 2014

2014-04-08T21:40:35Z

Show changes

Steven Solie: Steven Solie moved page Intuition Mouse and Keyboard to Intuition Mouse without leaving a redirect: Splitting into sections

2014-04-08T21:33:57Z

Steven Solie moved page Intuition Mouse and Keyboard to Intuition Mouse without leaving a redirect: Splitting into sections

← Older revision	Revision as of 21:33, 8 April 2014
(No difference)

Steven Solie: /* Select Button */

2013-05-23T19:58:45Z

Select Button

← Older revision		Revision as of 19:58, 23 May 2013
Line 50:		Line 50:
	A number of other common techniques involving the select button are available. They include:		A number of other common techniques involving the select button are available. They include:

			; Drag Select
	Multiple objects or an extended area may be selected by dragging the mouse over a range with the select button held down. For instance, multiple icons can be selected in a Workbench window by pressing the select button while the pointer is over the background of the window (not an icon or a system gadget) and then moving the mouse with the select button held down. A selection rectangle will be displayed and all icons within the rectangle will be selected. Similarly, the user may highlight blocks of text in a console window by pressing the select button over the first desired character and dragging the mouse to the last desired character while holding the button down.		: Multiple objects or an extended area may be selected by dragging the mouse over a range with the select button held down. For instance, multiple icons can be selected in a Workbench window by pressing the select button while the pointer is over the background of the window (not an icon or a system gadget) and then moving the mouse with the select button held down. A selection rectangle will be displayed and all icons within the rectangle will be selected. Similarly, the user may highlight blocks of text in a console window by pressing the select button over the first desired character and dragging the mouse to the last desired character while holding the button down.

			; Multi-Select or Shift Select
	Another way to select multiple objects or an extended area is through the shift select technique. First, select the first member of the group of objects in the normal way. Additional objects can be added to the group by holding down the Shift key while the select button is pressed. This technique works with Workbench icons, where icons may be added one-at-a-time to the list of selected icons; and with text in a console window, where the selected text is extended to include the new position. Note that text need not operate this way, and the application may allow multiple discrete blocks to be selected at any given time.		: Another way to select multiple objects or an extended area is through the shift select technique. First, select the first member of the group of objects in the normal way. Additional objects can be added to the group by holding down the Shift key while the select button is pressed. This technique works with Workbench icons, where icons may be added one-at-a-time to the list of selected icons; and with text in a console window, where the selected text is extended to include the new position. Note that text need not operate this way, and the application may allow multiple discrete blocks to be selected at any given time.

			; Cancel Drag Operation
	Both drag select and the dragging of individual objects may often be canceled by pressing the right mouse button before completing the drag operation (before releasing the select button). Examples of this include window dragging and sizing, and positioning of Workbench icons.		: Both drag select and the dragging of individual objects may often be canceled by pressing the right mouse button before completing the drag operation (before releasing the select button). Examples of this include window dragging and sizing, and positioning of Workbench icons.

	==== Menu Button ====		==== Menu Button ====

Steven Solie: /* Menu Shortcuts */

2013-05-23T19:57:14Z

Menu Shortcuts

← Older revision		Revision as of 19:57, 23 May 2013
Line 778:		Line 778:
	Menu items and sub-items may be paired with command key sequences to associate certain characters with specific menu item selections. This gives the user a shortcut method to select frequently used menu operations, such as Undo, Cut, and Paste. Whenever the user presses the right Amiga key with an alphanumeric key, the menu strip of the active window is scanned to see if there are any command key sequences in the list that match the sequence entered by the user. If there is a match, Intuition translates the key combination into the appropriate menu item number and transmits the menu number to the application program.		Menu items and sub-items may be paired with command key sequences to associate certain characters with specific menu item selections. This gives the user a shortcut method to select frequently used menu operations, such as Undo, Cut, and Paste. Whenever the user presses the right Amiga key with an alphanumeric key, the menu strip of the active window is scanned to see if there are any command key sequences in the list that match the sequence entered by the user. If there is a match, Intuition translates the key combination into the appropriate menu item number and transmits the menu number to the application program.

	{{Note\|title=Menu Shortcuts Look Like the Real Thing\|text=To the application it looks as if the user had selected a given menu item with the mouse. The program will receive a menu event, not a key event. For more information on menu item selection, see the "Intuition Menus" chapter.}}		{{Note\|title=Menu Shortcuts Look Like the Real Thing\|text=To the application it looks as if the user had selected a given menu item with the mouse. The program will receive a menu event, not a key event. For more information on menu item selection, see the [[Intuition_Menus\|Intuition Menus]] chapter.}}

	=== Amiga Qualifiers ===		=== Amiga Qualifiers ===

Steven Solie: /* Intuition Keyboard Shortcuts */

2013-05-23T19:56:36Z

Intuition Keyboard Shortcuts

← Older revision		Revision as of 19:56, 23 May 2013
Line 748:		Line 748:
	=== Intuition Keyboard Shortcuts ===		=== Intuition Keyboard Shortcuts ===

	If Intuition sees a command key sequence that means nothing to it, the key sequence is sent to the active window as usual. See the "Intuition Input and Output Methods" section for how this works. This section and the next section describe what Intuition does when it recognizes certain special command key sequences.		If Intuition sees a command key sequence that means nothing to it, the key sequence is sent to the active window as usual. See the [[Intuition_Input_and_Output_Methods\|Intuition Input and Output Methods]] section for how this works. This section and the next section describe what Intuition does when it recognizes certain special command key sequences.

	It is recommended that programs abide by certain command key standards to provide a consistent interface for Amiga users. The [[User_Interface_Style_Guide\|Amiga User Interface Style Guide]] contains a complete list of the recommended standards.		It is recommended that programs abide by certain command key standards to provide a consistent interface for Amiga users. The [[User_Interface_Style_Guide\|Amiga User Interface Style Guide]] contains a complete list of the recommended standards.

Steven Solie: /* The Sprite Data Structure */

2013-05-23T19:54:36Z

The Sprite Data Structure

← Older revision		Revision as of 19:54, 23 May 2013
Line 401:		Line 401:
	For example:		For example:

	[[File:LibFig10-1.png]]		[[File:LibFig10-1.png\|frame\|center]]

	Pointer Color Ordering. The first word in a line gives the least significant bit of the color register and the second word gives the most significant bit.		Pointer Color Ordering. The first word in a line gives the least significant bit of the color register and the second word gives the most significant bit.