![]() |
![]() |
![]() |
Clutter Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties | Signals |
struct ClutterDeviceManager; struct ClutterDeviceManagerClass; ClutterDeviceManager * clutter_device_manager_get_default (void
); GSList * clutter_device_manager_list_devices (ClutterDeviceManager *device_manager
); const GSList * clutter_device_manager_peek_devices (ClutterDeviceManager *device_manager
); ClutterInputDevice * clutter_device_manager_get_device (ClutterDeviceManager *device_manager
,gint device_id
); ClutterInputDevice * clutter_device_manager_get_core_device (ClutterDeviceManager *device_manager
,ClutterInputDeviceType device_type
); ClutterInputDevice * clutter_get_input_device_for_id (gint id_
);
ClutterDeviceManager is a singleton object, owned by Clutter, which maintains the list of ClutterInputDevices.
Depending on the backend used by Clutter it is possible to use the "device-added" and "device-removed" to monitor addition and removal of devices.
ClutterDeviceManager is available since Clutter 1.2
struct ClutterDeviceManager;
The ClutterDeviceManager structure contains only private data
Since 1.2
struct ClutterDeviceManagerClass { };
The ClutterDeviceManagerClass structure contains only private data
Since 1.2
ClutterDeviceManager * clutter_device_manager_get_default
(void
);
Retrieves the device manager singleton
Returns : |
the ClutterDeviceManager singleton. The returned instance is owned by Clutter and it should not be modified or freed. [transfer none] |
Since 1.2
GSList * clutter_device_manager_list_devices (ClutterDeviceManager *device_manager
);
Lists all currently registered input devices
|
a ClutterDeviceManager |
Returns : |
a newly allocated list of ClutterInputDevice objects. Use
g_slist_free() to deallocate it when done. [transfer container][element-type Clutter.InputDevice]
|
Since 1.2
const GSList * clutter_device_manager_peek_devices (ClutterDeviceManager *device_manager
);
Lists all currently registered input devices
|
a ClutterDeviceManager |
Returns : |
a pointer to the internal list of ClutterInputDevice objects. The returned list is owned by the ClutterDeviceManager and should never be modified or freed. [transfer none][element-type Clutter.InputDevice] |
Since 1.2
ClutterInputDevice * clutter_device_manager_get_device (ClutterDeviceManager *device_manager
,gint device_id
);
Retrieves the ClutterInputDevice with the given device_id
|
a ClutterDeviceManager |
|
the integer id of a device |
Returns : |
a ClutterInputDevice or NULL . The
returned device is owned by the ClutterDeviceManager and should
never be modified or freed. [transfer none]
|
Since 1.2
ClutterInputDevice * clutter_device_manager_get_core_device (ClutterDeviceManager *device_manager
,ClutterInputDeviceType device_type
);
Retrieves the core ClutterInputDevice of type device_type
Core devices are devices created automatically by the default Clutter backend
|
a ClutterDeviceManager |
|
the type of the core device |
Returns : |
a ClutterInputDevice or NULL . The
returned device is owned by the ClutterDeviceManager and should
not be modified or freed. [transfer none]
|
Since 1.2
ClutterInputDevice * clutter_get_input_device_for_id (gint id_
);
clutter_get_input_device_for_id
has been deprecated since version 1.10 and should not be used in newly-written code. Use clutter_device_manager_get_device()
instead.
Retrieves the ClutterInputDevice from its id_
. This is a convenience
wrapper for clutter_device_manager_get_device()
and it is functionally
equivalent to:
1 2 3 4 5 |
ClutterDeviceManager *manager; ClutterInputDevice *device; manager = clutter_device_manager_get_default (); device = clutter_device_manager_get_device (manager, id); |
|
the unique id for a device |
Returns : |
a ClutterInputDevice, or NULL . [transfer none]
|
Since 0.8
"backend"
property"backend" ClutterBackend* : Read / Write / Construct Only
The ClutterBackend of the device manager.
"device-added"
signalvoid user_function (ClutterDeviceManager *manager,
ClutterInputDevice *device,
gpointer user_data) : Run Last
The ::device-added signal is emitted each time a device has been added to the ClutterDeviceManager
|
the ClutterDeviceManager that emitted the signal |
|
the newly added ClutterInputDevice |
|
user data set when the signal handler was connected. |
Since 1.2
"device-removed"
signalvoid user_function (ClutterDeviceManager *manager,
ClutterInputDevice *device,
gpointer user_data) : Run Last
The ::device-removed signal is emitted each time a device has been removed from the ClutterDeviceManager
|
the ClutterDeviceManager that emitted the signal |
|
the removed ClutterInputDevice |
|
user data set when the signal handler was connected. |
Since 1.2