| Top |
RBRemovableMediaManagerRBRemovableMediaManager — handling of removable media such as audio CDs and DAP devices |
Description
The removable media manager maintains the mapping between GIO GVolume and GMount objects and rhythmbox sources.
Functions
rb_removable_media_manager_new ()
RBRemovableMediaManager *
rb_removable_media_manager_new (RBShell *shell);
Creates the RBRemovableMediaManager instance.
rb_removable_media_manager_scan ()
void
rb_removable_media_manager_scan (RBRemovableMediaManager *manager);
Initiates a new scan of all attached media. Newly activated plugins that use
the create-source-volume or create-source-mount signals should call this if
the 'scanned' property is TRUE. Otherwise, the first scan will catch any
existing volumes or mounts that the plugin is interested in.
Types and Values
struct RBRemovableMediaManagerClass
struct RBRemovableMediaManagerClass {
GObjectClass parent_class;
/* signals */
void (*medium_added) (RBRemovableMediaManager *mgr,
RBSource *source);
RBSource * (*create_source_device) (RBRemovableMediaManager *mgr,
GObject *device); /* actually a GUdevDevice */
RBSource * (*create_source_mount) (RBRemovableMediaManager *mgr,
GMount *mount,
MPIDDevice *device_info);
RBSource * (*create_source_volume) (RBRemovableMediaManager *mgr,
GVolume *volume);
};
Property Details
The “scanned” property
“scanned” gboolean
This is set to TRUE when the removable media manager has scanned all existing volumes and mounts. When a plugin that handles removable media is activated, it should request a new scan if this property is already set to TRUE.
Flags: Read
Default value: FALSE
Signal Details
The “create-source-device” signal
RBSource* user_function (RBRemovableMediaManager *mgr, GObject *device, gpointer user_data)
Emitted when a new device is detected to allow plugins to create a corresponding RBSource. The first signal handler that returns a source wins. Plugins should only use this signal if there will be no GVolume or GMount created for the device.
Parameters
mgr |
||
device |
the device (actually a GUdevDevice) |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
The “create-source-mount” signal
RBSource* user_function (RBRemovableMediaManager *mgr, GMount *device_info, MPIDDevice *mount, gpointer user_data)
Emitted when a new mount is added to allow plugins to create a corresponding RBSource. The first signal handler that returns a source wins. If a source was created for the GVolume for a mount, then this signal will not be emitted.
Parameters
mgr |
||
device_info |
a MPIDDevice containing information on the device |
|
mount |
the GMount |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
The “create-source-volume” signal
RBSource* user_function (RBRemovableMediaManager *mgr, GVolume *volume, gpointer user_data)
Emitted when a new volume is added to allow plugins to create a corresponding RBSource. The first signal handler that returns a source wins. A plugin should only use this signal if it doesn't require the volume to be mounted. If the volume must be mounted to be useful, use the create-source-mount signal instead.
Flags: Run Last
The “medium-added” signal
void user_function (RBRemovableMediaManager *mgr, GObject *source, gpointer user_data)
Emitted when a new source is added for a removable medium.
Parameters
mgr |
||
source |
the newly added RBSource |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
