gio.VolumeMonitor — Volume Monitor.
class gio.VolumeMonitor(gobject.GObject): |
Functionsdef gio.volume_monitor_adopt_orphan_mount()def gio.volume_monitor_get()
gobject.GObject Signal Prototypes
def callback( | |
def callback( | |
def callback( | |
def callback( | |
def callback( | |
def callback( | |
def callback( | |
def callback( | |
def callback( | |
def callback( | |
def callback( |
The gio.VolumeMonitor
is for listing the user interesting devices and volumes on the computer. In other words,
what a file selector or file manager would show in a sidebar.
def get_connected_drives()Returns : | a list of connected
gio.Drive objects.
|
The get_connected_drives() method gets a list
of drives connected to the system.
def get_mount_for_uuid(uuid)
| The UUID to look for. |
Returns : | A
gio.Mount
or None if no such mount is available.
|
The get_mount_for_uuid() method finds a
gio.Mount
object by it's UUID (see
gio.Mount.get_uuid())
def get_mounts()Returns : | A list of
gio.Mount
objects.
|
The get_mounts() method gets a list of the mounts on the system.
def get_volume_for_uuid(uuid)
| The UUID to look for. |
Returns : | A
gio.Volume
or None if no such volume is available.
|
The get_mount_for_uuid() method finds a
gio.Mount
object by it's UUID (see
gio.Mount.get_uuid())
def get_volumes()Returns : | A list of
gio.Volume
objects.
|
The get_volumes() method gets a list of the volumes on the system.
def volume_monitor_adopt_orphan_mount()Returns : | The gio.Volume
object that is the parent for mount or None if no wants to adopt the
gio.Mount.
|
This method will be deprecated starting from GIO 2.20
The volume_monitor_adopt_orphan_mount() function should
be called by any gio.VolumeMonitor
implementation when a new gio.Mount
object is created that is not associated with a
gio.Volume object.
It must be called just before emitting the mount_added signal.
If the return value is not None, the caller must associate the returned
gio.Volume
object with the
gio.Mount.
This involves returning it in it's
Similary, if implementing
gio.volume_monitor_adopt_orphan_mount(),
the implementor must take a reference to mount and return it in it's
gio.Volume.get_mount()
implemented. Also, the implementor must listen for the "unmounted" signal
on mount and give up it's reference upon handling that signal.
There are two main use cases for this function.
One is when implementing a user space file system driver that reads blocks of
a block device that is already represented by the native volume monitor
(for example a CD Audio file system driver). Such a driver will generate it's own
gio.Mount
object that needs to be assoicated with the
gio.Volume
object that represents the volume.
The other is for implementing a
gio.VolumeMonitor
whose sole purpose is to return
gio.Volume
objects representing entries in the users "favorite servers" list or similar.
def volume_monitor_get()Returns : | A reference to the
gio.VolumeMonitor
used by gio.
|
The volume_monitor_get() function gets the
volume monitor used by gio.
def callback(volume_monitor, drive, user_param1, ...)
| the volume monitor |
| the drive that changed |
| the first user parameter (if any) specified
with the connect()
method |
| additional user parameters (if any) |
Emitted when a drive changes.
def callback(volume_monitor, drive, user_param1, ...)
| the volume monitor |
| the drive that was connected |
| the first user parameter (if any) specified
with the connect()
method |
| additional user parameters (if any) |
Emitted when a drive is connected to the system.
def callback(volume_monitor, drive, user_param1, ...)
| the volume monitor |
| the drive that was disconnected |
| the first user parameter (if any) specified
with the connect()
method |
| additional user parameters (if any) |
Emitted when a drive is disconnected from the system.
def callback(volume_monitor, drive, user_param1, ...)
| the volume monitor |
| the drive where the eject button was pressed |
| the first user parameter (if any) specified
with the connect()
method |
| additional user parameters (if any) |
Emitted when the eject button is pressed on drive.
def callback(volume, mount, user_param1, ...)
| the volume monitor |
| a Mount that was added. |
| the first user parameter (if any) specified
with the connect()
method |
| additional user parameters (if any) |
Emitted when a mount is added.
def callback(volume_monitor, mount, user_param1, ...)
| the volume monitor |
| the Mount that changed. |
| the first user parameter (if any) specified
with the connect()
method |
| additional user parameters (if any) |
Emitted when a mount changes.
def callback(volume_monitor, mount, user_param1, ...)
| the volume monitor |
| the Mount that is being unmounted. |
| the first user parameter (if any) specified
with the connect()
method |
| additional user parameters (if any) |
Emitted when a mount is about to be removed.
def callback(volume_monitor, mount, user_param1, ...)
| the volume monitor |
| the Mount that was removed. |
| the first user parameter (if any) specified
with the connect()
method |
| additional user parameters (if any) |
Emitted when a mount is removed.
def callback(volume_monitor, volume, user_param1, ...)
| the volume monitor |
| a Volume that was added. |
| the first user parameter (if any) specified
with the connect()
method |
| additional user parameters (if any) |
Emitted when a mountable volume is added to the system.
def callback(volume_monitor, volume, user_param1, ...)
| the volume monitor |
| a Volume that changed. |
| the first user parameter (if any) specified
with the connect()
method |
| additional user parameters (if any) |
Emitted when mountable volume is changed.
def callback(volume_monitor, volume, user_param1, ...)
| the volume monitor |
| a Volume that was removed. |
| the first user parameter (if any) specified
with the connect()
method |
| additional user parameters (if any) |
Emitted when a mountable volume is removed from the system.