dix: refine docs on DeliverDeviceEvents()
Adding a bit more explaination on how events are passed upwards. Signed-off-by: Enrico Weigelt, metux IT consult <info@metux.net>
This commit is contained in:
		
							parent
							
								
									788ed2c127
								
							
						
					
					
						commit
						59353fdefd
					
				| 
						 | 
					@ -2867,6 +2867,9 @@ DeliverOneEvent(InternalEvent *event, DeviceIntPtr dev, enum InputLevel level,
 | 
				
			||||||
 * For focused events, DeliverFocusedEvent is called first, and _may_ call
 | 
					 * For focused events, DeliverFocusedEvent is called first, and _may_ call
 | 
				
			||||||
 * DeliverDeviceEvents.
 | 
					 * DeliverDeviceEvents.
 | 
				
			||||||
 *
 | 
					 *
 | 
				
			||||||
 | 
					 * If the event can't be delivered to the given window itself, trying it's
 | 
				
			||||||
 | 
					 * parents, up until we find one that's taking the event.
 | 
				
			||||||
 | 
					 *
 | 
				
			||||||
 * @param pWin Window to deliver event to.
 | 
					 * @param pWin Window to deliver event to.
 | 
				
			||||||
 * @param event The events to deliver, not yet in wire format.
 | 
					 * @param event The events to deliver, not yet in wire format.
 | 
				
			||||||
 * @param grab Possible grab on a device.
 | 
					 * @param grab Possible grab on a device.
 | 
				
			||||||
| 
						 | 
					@ -2886,6 +2889,7 @@ DeliverDeviceEvents(WindowPtr pWin, InternalEvent *event, GrabPtr grab,
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    verify_internal_event(event);
 | 
					    verify_internal_event(event);
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					    // try the window and all its parent, whichever one first wants the event
 | 
				
			||||||
    while (pWin) {
 | 
					    while (pWin) {
 | 
				
			||||||
        if ((mask = EventIsDeliverable(dev, event->any.type, pWin))) {
 | 
					        if ((mask = EventIsDeliverable(dev, event->any.type, pWin))) {
 | 
				
			||||||
            /* XI2 events first */
 | 
					            /* XI2 events first */
 | 
				
			||||||
| 
						 | 
					@ -2910,7 +2914,6 @@ DeliverDeviceEvents(WindowPtr pWin, InternalEvent *event, GrabPtr grab,
 | 
				
			||||||
                if (deliveries > 0)
 | 
					                if (deliveries > 0)
 | 
				
			||||||
                    break;
 | 
					                    break;
 | 
				
			||||||
            }
 | 
					            }
 | 
				
			||||||
 | 
					 | 
				
			||||||
        }
 | 
					        }
 | 
				
			||||||
 | 
					
 | 
				
			||||||
        if ((deliveries < 0) || (pWin == stopAt) ||
 | 
					        if ((deliveries < 0) || (pWin == stopAt) ||
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
		Loading…
	
		Reference in New Issue