Trait gio::prelude::DriveExt[−][src]

pub trait DriveExt: 'static {

Show methods    fn can_eject(&self) -> bool;

    fn can_poll_for_media(&self) -> bool;

    fn can_start(&self) -> bool;

    fn can_start_degraded(&self) -> bool;

    fn can_stop(&self) -> bool;

    fn eject_with_operation<P: IsA<MountOperation>, Q: IsA<Cancellable>, R: FnOnce(Result<(), Error>) + Send + 'static>(
        &self, 
        flags: MountUnmountFlags, 
        mount_operation: Option<&P>, 
        cancellable: Option<&Q>, 
        callback: R
    );

    fn eject_with_operation_future<P: IsA<MountOperation> + Clone + 'static>(
        &self, 
        flags: MountUnmountFlags, 
        mount_operation: Option<&P>
    ) -> Pin<Box_<dyn Future<Output = Result<(), Error>> + 'static>>;

    fn enumerate_identifiers(&self) -> Vec<GString>;

    fn icon(&self) -> Icon;

    fn identifier(&self, kind: &str) -> Option<GString>;

    fn name(&self) -> GString;

    fn sort_key(&self) -> Option<GString>;

    fn start_stop_type(&self) -> DriveStartStopType;

    fn symbolic_icon(&self) -> Icon;

    fn volumes(&self) -> Vec<Volume>;

    fn has_media(&self) -> bool;

    fn has_volumes(&self) -> bool;

    fn is_media_check_automatic(&self) -> bool;

    fn is_media_removable(&self) -> bool;

    fn is_removable(&self) -> bool;

    fn poll_for_media<P: IsA<Cancellable>, Q: FnOnce(Result<(), Error>) + Send + 'static>(
        &self, 
        cancellable: Option<&P>, 
        callback: Q
    );

    fn poll_for_media_future(
        &self
    ) -> Pin<Box_<dyn Future<Output = Result<(), Error>> + 'static>>;

    fn start<P: IsA<MountOperation>, Q: IsA<Cancellable>, R: FnOnce(Result<(), Error>) + Send + 'static>(
        &self, 
        flags: DriveStartFlags, 
        mount_operation: Option<&P>, 
        cancellable: Option<&Q>, 
        callback: R
    );

    fn start_future<P: IsA<MountOperation> + Clone + 'static>(
        &self, 
        flags: DriveStartFlags, 
        mount_operation: Option<&P>
    ) -> Pin<Box_<dyn Future<Output = Result<(), Error>> + 'static>>;

    fn stop<P: IsA<MountOperation>, Q: IsA<Cancellable>, R: FnOnce(Result<(), Error>) + Send + 'static>(
        &self, 
        flags: MountUnmountFlags, 
        mount_operation: Option<&P>, 
        cancellable: Option<&Q>, 
        callback: R
    );

    fn stop_future<P: IsA<MountOperation> + Clone + 'static>(
        &self, 
        flags: MountUnmountFlags, 
        mount_operation: Option<&P>
    ) -> Pin<Box_<dyn Future<Output = Result<(), Error>> + 'static>>;

    fn connect_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId;

    fn connect_disconnected<F: Fn(&Self) + 'static>(
        &self, 
        f: F
    ) -> SignalHandlerId;

    fn connect_eject_button<F: Fn(&Self) + 'static>(
        &self, 
        f: F
    ) -> SignalHandlerId;

    fn connect_stop_button<F: Fn(&Self) + 'static>(
        &self, 
        f: F
    ) -> SignalHandlerId;

}
Expand description

Trait containing all Drive methods.

Implementors

Drive

Required methods

Checks if a drive can be ejected.

Returns

true if the self can be ejected, false otherwise.

Checks if a drive can be polled for media changes.

Returns

true if the self can be polled for media changes, false otherwise.

Checks if a drive can be started.

Returns

true if the self can be started, false otherwise.

Checks if a drive can be started degraded.

Returns

true if the self can be started degraded, false otherwise.

Checks if a drive can be stopped.

Returns

true if the self can be stopped, false otherwise.

Ejects a drive. This is an asynchronous operation, and is finished by calling g_drive_eject_with_operation_finish() with the self and AsyncResult data returned in the callback.

flags

flags affecting the unmount if required for eject

mount_operation

a MountOperation or None to avoid user interaction.

cancellable

optional Cancellable object, None to ignore.

callback

a GAsyncReadyCallback, or None.

Gets the kinds of identifiers that self has. Use identifier() to obtain the identifiers themselves.

Returns

a None-terminated array of strings containing kinds of identifiers. Use g_strfreev() to free.

Gets the icon for self.

Returns

Icon for the self. Free the returned object with g_object_unref().

Gets the identifier of the given kind for self. The only identifier currently available is DRIVE_IDENTIFIER_KIND_UNIX_DEVICE.

kind

the kind of identifier to return

Returns

a newly allocated string containing the requested identifier, or None if the Drive doesn’t have this kind of identifier.

Gets the name of self.

Returns

a string containing self’s name. The returned string should be freed when no longer needed.

Gets the sort key for self, if any.

Returns

Sorting key for self or None if no such key is available.

Gets a hint about how a drive can be started/stopped.

Returns

A value from the DriveStartStopType enumeration.

Gets the icon for self.

Returns

symbolic Icon for the self. Free the returned object with g_object_unref().

Get a list of mountable volumes for self.

The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref().

Returns

GList containing any Volume objects on the given self.

Checks if the self has media. Note that the OS may not be polling the drive for media changes; see is_media_check_automatic() for more details.

Returns

true if self has media, false otherwise.

Check if self has any mountable volumes.

Returns

true if the self contains volumes, false otherwise.

Checks if self is capable of automatically detecting media changes.

Returns

true if the self is capable of automatically detecting media changes, false otherwise.

Checks if the self supports removable media.

Returns

true if self supports removable media, false otherwise.

This is supported on crate feature v2_50 only.

Checks if the Drive and/or its media is considered removable by the user. See is_media_removable().

Returns

true if self and/or its media is considered removable, false otherwise.

Asynchronously polls self to see if media has been inserted or removed.

When the operation is finished, callback will be called. You can then call g_drive_poll_for_media_finish() to obtain the result of the operation.

cancellable

optional Cancellable object, None to ignore.

callback

a GAsyncReadyCallback, or None.

Asynchronously starts a drive.

When the operation is finished, callback will be called. You can then call g_drive_start_finish() to obtain the result of the operation.

flags

flags affecting the start operation.

mount_operation

a MountOperation or None to avoid user interaction.

cancellable

optional Cancellable object, None to ignore.

callback

a GAsyncReadyCallback, or None.

Asynchronously stops a drive.

When the operation is finished, callback will be called. You can then call g_drive_stop_finish() to obtain the result of the operation.

flags

flags affecting the unmount if required for stopping.

mount_operation

a MountOperation or None to avoid user interaction.

cancellable

optional Cancellable object, None to ignore.

callback

a GAsyncReadyCallback, or None.

Emitted when the drive’s state has changed.

This signal is emitted when the Drive have been disconnected. If the recipient is holding references to the object they should release them so the object can be finalized.

Emitted when the physical eject button (if any) of a drive has been pressed.

Emitted when the physical stop button (if any) of a drive has been pressed.

Implementors