brl/mutter
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

[docs] Specify the coordinate space of ButtonEvent

Browse Source 
The coordinates of each ButtonEvent are relative to the stage that
received the event, so we should document this in the structure
annotation.

It should also be mentioned that the coordinates can be transformed
into actor-relative coordinates by using transform_stage_point().
This commit is contained in:
Emmanuele Bassi 2009-01-21 22:03:31 +00:00
parent ee883f30d4
commit c5aca39c69
1 changed files with 9 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
clutter/clutter-event.h
View File

@ -264,8 +264,8 @@ struct _ClutterKeyEvent
* @flags: event flags * @flags: event flags
* @stage: event source stage * @stage: event source stage
* @source: event source actor * @source: event source actor
* @x: event X coordinate * @x: event X coordinate, relative to the stage
* @y: event Y coordinate * @y: event Y coordinate, relative to the stage
* @modifier_state: button modifiers * @modifier_state: button modifiers
* @button: event button * @button: event button
* @click_count: number of button presses within the default time * @click_count: number of button presses within the default time
@ -273,7 +273,11 @@ struct _ClutterKeyEvent
* @axes: reserved for future use * @axes: reserved for future use
* @device: reserved for future use * @device: reserved for future use
* *
* Button event * Button event.
*
* The event coordinates are relative to the stage that received the
* event, and can be transformed into actor-relative coordinates by
* using clutter_actor_transform_stage_point().
* *
* Since: 0.2 * Since: 0.2
*/ */