ggiEventRead man page on Mageia

Man page or keyword search:  
man Server   17783 pages
apropos Keyword Search (all sections)
Output format
Mageia logo
[printable version]

ggiJoinInputs(3)		      GGI		      ggiJoinInputs(3)

NAME
       ggiJoinInputs,  ggiEventPoll, ggiEventSelect, ggiEventsQueued, ggiEven‐
       tRead,  ggiSetEventMask,	  ggiGetEventMask,   ggiAddEventMask,	ggiRe‐
       moveEventMask : Event management for LibGGI visual

SYNOPSIS
       #include <ggi/ggi.h>

       gii_event_mask ggiEventPoll(ggi_visual_t vis, gii_event_mask mask,
				   struct timeval *t);

       int ggiEventsQueued(ggi_visual_t vis, gii_event_mask mask);

       int ggiEventRead(ggi_visual_t vis, gii_event *ev,
			gii_event_mask mask);

       int ggiSetEventMask(ggi_visual_t vis, gii_event_mask evm);

       gii_event_mask ggiGetEventMask(ggi_visual_t vis);

       gii_input_t ggiJoinInputs(ggi_visual_t vis, gii_input_t inp);

       #define ggiAddEventMask(vis,mask)  \
		     ggiSetEventMask((vis), ggiGetEventMask((vis)) | (mask))

       #define ggiRemoveEventMask(vis,mask)  \
		     ggiSetEventMask((vis), ggiGetEventMask((vis)) & ~(mask))

DESCRIPTION
       LibGGI  provides input facilities through an auxiliary library, LibGII.
       Each LibGGI visual internally contains a	 gii_input_t  input,  and  all
       LibGII  functions  are available to manipulate and process inputs.  The
       LibGGI versions	provided  of  most  LibGII  functions  simply  take  a
       ggi_visual_t  rather  than  gii_input_t for convenience during everyday
       usage.  Events are LibGII types.	 All other semantics are the same; see
       libgii(7) for details.
	      Important:  By  default  LibGGI  visuals autodetect and open the
	      appropriate inputs, including mouse and keyboard and  any	 other
	      inputs  that  are	 under	the X target.  Thus in the usual cases
	      there is no need to open a LibGII gii_input_t directly (and that
	      may  in fact fail because an input device is already open).  The
	      LibGGI ggiEvent* functions must be used  to  do  event  handling
	      with  LibGGI  visuals,  and  provide  adequate  support for most
	      everyday, single-visual usage.

	      Advanced management of input sources is accomplished by  detach‐
	      ing  the input from the visual and using LibGII functions on the
	      separate visual handle (see ggiDetachInput(3)).  This is encour‐
	      aged,  for  example,  when joining inputs from multiple visuals,
	      because when two visuals share the same joined input, you cannot
	      ggiClose both of the visuals (a fatal error will result, because
	      closing the first visual closes both of the  joined  inputs  and
	      leaves the second closed visual with a stale input handle.)

RETURN VALUE
       See  return  values  of	giiJoinInputs(3), giiEventPoll(3), giiEventSe‐
       lect(3),	  giiEventsQueued(3),	giiEventRead(3),   giiSetEventMask(3),
       giiGetEventMask(3), giiAddEventMask(3), giiRemoveEventMask(3)

SEE ALSO
       ggiGetInput(3), giiEventPoll(3), giiSetEventMask(3)

libggi-2.2.x			  2006-12-30		      ggiJoinInputs(3)
[top]

List of man pages available for Mageia

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net