| Event | |
|
| Expose | The expose event.
- A region of widget that receives this event needs to be redrawn.
This event is the result of revealing part or all of a window
or by the application calling functions like widgetQueueDrawArea.
|
| sent :: Bool | | | area :: Rectangle | A bounding box denoting what needs to be updated. For a more
detailed information on the area that needs redrawing, use the
next field.
| | region :: Region | A set of horizontal stripes that denote the invalid area.
| | count :: Int | The number of contiguous Expose events following this
one. The only use for this is exposure compression, i.e.
handling all contiguous Expose events in one go, though Gdk
performs some exposure compression so this is not normally needed.
|
|
| Motion | Mouse motion.
- Captures the movement of the mouse cursor while it is within the area
of the widget.
|
| sent :: Bool | | | time :: Integer | | | x, y :: Double | | | modif :: [Modifier] | | | isHint :: Bool | Indicate if this event is only a hint of the motion.
- If the PointerMotionHintMask is set with widgetAddEvents then
mouse positions are only generated each time a drawWindowGetPointer
is called. In this case isHint is set to True.
| | xRoot, yRoot :: Double | |
|
| Button | A mouse button was pressed or released.
- This event is triggered if the mouse button was pressed or released
while the mouse cursor was within the region of the widget.
|
| sent :: Bool | | | click :: Click | The kind of button press, see Click. Note that double clicks will
trigger this event with click set to SingleClick, ReleaseClick,
SingleClick, DoubleClick, ReleaseClick. Triple clicks will
produce this sequence followed by SingleClick, DoubleClick,
TripleClick, ReleaseClick.
| | time :: Integer | The time of the event in milliseconds.
| | x, y :: Double | | | modif :: [Modifier] | | | button :: Button | The button that was pressed.
| | xRoot, yRoot :: Double | The coordinates of the click relative the the screen origin.
|
|
| Key | A key was pressed while the widget had the input focus.
- If the widget has the current input focus (see widgetSetCanFocus)
it will receive key pressed events. Certain key combinations are of
no interest to a normal widget like Alt-F to access the file menu.
For all these keys, the handler must return False to indicate that
the key stroke should be propagated to the parent widget. At the
top-level widget, keyboard shortcuts like Alt-F are turned into the
corresponding signals.
|
| release :: Bool | This flag is set if the key was released. This flag makes it possible
to connect the same handler to onKeyPress and onKeyRelease.
| | sent :: Bool | | | time :: Integer | | | modif :: [Modifier] | | | withCapsLock :: Bool | This flag is True if Caps Lock is on while this key was pressed.
| | withNumLock :: Bool | This flag is True if Number Lock is on while this key was pressed.
| | withScrollLock :: Bool | This flag is True if Scroll Lock is on while this key was pressed.
| | keyName :: String | A string representing the key that was pressed or released.
- This string contains a description of the key rather than what
should appear on screen. For example, pressing 1 on the keypad
results in KP_1. Of particular interest are F1 till F12,
for a complete list refer to "gdk/gdkkeysyms.h" where all
possible values are defined. The corresponding strings are the
constants without the GDK_ prefix.
| | keyChar :: (Maybe Char) | A character matching the key that was pressed.
- This entry can be used to build up a whole input string.
The character is Nothing if the key does not correspond to a simple
unicode character.
|
|
| Crossing | Mouse cursor crossing event.
- This event indicates that the mouse cursor is hovering over this
widget. It is used to set a widget into the pre-focus state where
some GUI elements like buttons on a toolbar change their appearance.
|
| sent :: Bool | | | time :: Integer | | | x, y :: Double | | | xRoot, yRoot :: Double | | | cMode :: CrossingMode | Kind of enter/leave event.
- The mouse cursor might enter this widget because it grabs the mouse
cursor for e.g. a modal dialog box.
| | nType :: NotifyType | Information on from what level of the widget hierarchy the mouse
cursor came.
| | modif :: [Modifier] | |
|
| Focus | Gaining or loosing input focus.
|
| sent :: Bool | | | inFocus :: Bool | This flag is True if the widget receives the focus and False if
it just lost the input focus.
|
|
| Configure | The widget's size has changed.
- In response to this event the application can allocate resources that
are specific to the size of the widget. It is emitted when the widget
is shown the first time and on every resize.
|
| sent :: Bool | | | xPar :: Int | Position within the parent window.
| | yPar :: Int | Position within the parent window.
| | width :: Int | | | height :: Int | |
|
| Visibility | Change of visibility of a widget.
|
|
| Scroll | Wheel movement of the mouse.
- This action denotes that the content of the widget should be scrolled.
The event is triggered by the movement of the mouse wheel. Surrounding
scroll bars are independant of this signal. Most mice do not have
buttons for horizontal scrolling, hence direc will usually not
contain ScrollLeft and ScrollRight. Mice with additional
buttons may not work on X since only five buttons are supported
(the three main buttons and two for the wheel).
- The handler of this signal should update the scroll bars that
surround this widget which in turn tell this widget to update.
|
|
| WindowState | Indicate how the appearance of this window has changed.
|
| sent :: Bool | | | wMask :: WindowState | The mask indicates which flags have changed.
| | wState :: WindowState | The state indicates the current state of the window.
|
|
| Proximity | The state of the pen of a graphics tablet pen.
|
| sent :: Bool | | | time :: Integer | | | touches :: Bool | Whether the pen was removed or set onto the tablet.
|
|
Instances