Pager2 - Jun 99 - by christophe LOREK
-------------------------------------

People will appear in a list.
When a client doubleclicks on a user name of the list, if no message has been
received from that user, this opens a text editing window to send a message,
otherwise it will open the incoming messages.
When receiving a message, if the list is not open, the 'blink box' will blink
to notify the new message. The icon next to the name of the sender will change
to indicate a message has been received. 

this pager can be used with the ignore module to ignore incoming pager
messages.

------------------------------------------------------------------------------
Editor:
 Five bitmaps must be provided (they can be BMP or JPG files)
 
 - no messages BMP : 
  bitmap displayed in the list when no message has been received from the user.
  (the size must be 16 pixels wide by 16 pixels high, otherwise only the top
  left part of the image will be used)
  
 - incoming messages BMP :
  bitmap displayed in the list when a message has been received from the user.
  (the size must be 16 pixels wide by 16 pixels high, otherwise only the top
  left part of the image will be used)
 
 - Pager Button BMP :
  bitmap displayed on the pager's button. (can be any size, will automatically
  fit the zone)

 - Box Blink up BMP : 
   bitmap displayed when no message has been received. (can be any size, will
   automatically fit the zone)

 - Box Blink down BMP : 
   bitmap displayed in alterance with 'Box Blink up BMP' when a message has
   been received. (can be any size, will automatically fit the zone)

------------------------------------------------------------------------------
Actions:
 - start :
  creates the client.
  
 - destroy :
  destroyes the client.
 
 - show :
  displayes the pager list.
 
 - hide :
  hides the pager list.
  
 - changelogin :
  must be connected to a login module to change the names in the pager list
  when clients change their names.
  
 - page :
  this sends a message to a client whose Id is specified has parameter.
  
 - IgnoreFlag :
  must be connected to the IgnoreFlag event of the ignore module to provide
  ignore function for the pager.

------------------------------------------------------------------------------
Events:
 - select :
  when a user has been selected on the pager list, this event is emitted
  containing the client Id of this user.
  
 - entering :
  notifies that a new client is entering (created).
 
 - destroyed :
  notifies that the client has been destroyed.
 
 - incomingMsg :
  notifies that a message has been received (can be connected to a sound module
  to play a sound when a message has been received).

 - shown :
  notifies that the pager list has been displayed.
  
 - hidden :
  notifies that the pager list has been hidden.
  
 - started :
  notifies that the client has been started.

 - BoxClick :
  when a client clicks on the blink box, this event is emitted (can be
  connected to the show action to show the pager list).
  
------------------------------------------------------------------------------
Zones:
 - "pager" : 
  the zone corresponding to the pager list.
 
 - "button" :
  the zone corresponding to the pager button (button with bitmap) (not necessary).
  the bitmap is resized to fit the zone.
 
 - "box" :
  the one corresponding to the blinkbox.
  the bitmap is resized to fit the zone.
