Proposal for Version 0.4 of Xfixes Extension

[Deron Johnson]

Here is a proposal for Version 0.4 of the Xfixes extension. It includes
both the grab event and the show/hide cursor request that Keith and I
have been discussing. Please let us know what you think.


Author:            Deron Johnson
Document Version:  0.1 (DRAFT)
Date:		   Thu Jan 19 14:19:38 PST 2006
Subject:	   Proposal for Version 0.4 of Xfixes Extension

Add: Grab State Change Notification
-----------------------------------

When a grab triggers, a GrabStateChange event with trigger==True will
be sent to clients interested in GrabStateChange events for the grab
window. If the grab that triggered was passive the type field will be
set to GrabTypePassive, otherwise it will be set to GrabTypeActive. If
the grab that triggered was specified by some client, the detail field
will be set to GrabDetailClient, otherwise it will be set to
GrabDetailDefault.

When a grab terminates, a GrabStateChange event with trigger==False
will be sent to clients interested in GrabStateChange events for the
grab window. The type field will be set to GrabTypeNone and the and
the detail field will be set to GrabDetailNone.

Types:

	GRABSTATECHANGEEVENT	{ GrabStateChange }
	GRABTYPE		{ GrabTypeNone, GrabTypePassive
				  GrabTypeActive }
        GRABDETAIL              { GrabDetailNone, GrabDetailClient,
				  GrabDetailDefault }

Events:

GrabStateChange

	subtype:		GRABSTATECHANGEEVENT
	window:			Window
        trigger:                BOOL
        type:                   GRABTYPE
	detail:			GRABDETAIL

Requests:

SelectGrabStateChangeInput

	window:			Window
	event-mask:		SETofGRABSTATECHANGEEVENT

	This request tells the X server that the client is interested in
        receiving GrabStateChange events for the specified window.


Add: Cursor Visibility Modification
-----------------------------------

Requests:

HideCursor

	This request tells the X server that the cursor image of the
        X cursor should not be displayed.

        Note that while the cursor is not displayed, CursorNotify events
	are sent as usual.

ShowCursor

	This request tells the X server that the cursor image of the
        X cursor should be displayed.