Klasse Mount

Alle implementierten Schnittstellen:
PointerInterface

public class Mount extends Interface
The `GMount` interface represents a user-visible mount, such as a mounted
file system.

`GMount` is a ‘mounted’ filesystem that you can access. Mounted is in
quotes because it’s not the same as a UNIX mount, it might be a GVFS
mount, but you can still access the files on it if you use GIO.

A `GMount` might be associated with a [iface@Gio.Volume] (such as a USB flash
drive) which hosts it.

Unmounting a `GMount` instance is an asynchronous operation. For
more information about asynchronous operations, see [iface@Gio.AsyncResult]
and [class@Gio.Task]. To unmount a `GMount` instance, first call
[method@Gio.Mount.unmount_with_operation] with (at least) the `GMount`
instance and a [type@Gio.AsyncReadyCallback]. The callback will be fired
when the operation has resolved (either with success or failure), and a
[iface@Gio.AsyncResult] structure will be passed to the callback. That
callback should then call [method@Gio.Mount.unmount_with_operation_finish]
with the `GMount` and the [iface@Gio.AsyncResult] data to see if the
operation was completed successfully. If an `error` is present when
[method@Gio.Mount.unmount_with_operation_finish] is called, then it will be
filled with any error information.

Note, when [porting from GnomeVFS](migrating-gnome-vfs.html), `GMount` is the
moral equivalent of `GnomeVFSVolume`.

https://docs.gtk.org/gio/iface.Mount.html

  • Felddetails

  • Konstruktordetails

  • Methodendetails

    • getClassHandler

      public static ClassHandler getClassHandler()
    • canEject

      public boolean canEject()
      Checks if @mount can be ejected.
      Gibt zurück:
      %TRUE if the @mount can be ejected.
    • canUnmount

      public boolean canUnmount()
      Checks if @mount can be unmounted.
      Gibt zurück:
      %TRUE if the @mount can be unmounted.
    • eject

      @Deprecated public void eject(int flags, @Nullable Cancellable cancellable, Mount.OnAsyncReadyCallback callback, @Nullable Pointer user_data)
      Veraltet.
      Ejects a mount. This is an asynchronous operation, and is
      finished by calling g_mount_eject_finish() with the @mount
      and #GAsyncResult data returned in the @callback.
      Parameter:
      flags - flags affecting the unmount if required for eject
      cancellable - optional #GCancellable object, %NULL to ignore.
      callback - a #GAsyncReadyCallback, or %NULL.
      user_data - user data passed to @callback.
    • ejectFinish

      @Deprecated public boolean ejectFinish(@Nonnull AsyncResult result) throws AllocationError
      Veraltet.
      Finishes ejecting a mount. If any errors occurred during the operation,
      @error will be set to contain the errors and %FALSE will be returned.
      Parameter:
      result - a #GAsyncResult.
      Gibt zurück:
      %TRUE if the mount was successfully ejected. %FALSE otherwise.
      Löst aus:
      AllocationError
    • ejectWithOperation

      public void ejectWithOperation(int flags, @Nullable MountOperation mount_operation, @Nullable Cancellable cancellable, Mount.OnAsyncReadyCallback callback, @Nullable Pointer user_data)
      Ejects a mount. This is an asynchronous operation, and is
      finished by calling g_mount_eject_with_operation_finish() with the @mount
      and #GAsyncResult data returned in the @callback.
      Parameter:
      flags - flags affecting the unmount if required for eject
      mount_operation - a #GMountOperation or %NULL to avoid user interaction.
      cancellable - optional #GCancellable object, %NULL to ignore.
      callback - a #GAsyncReadyCallback, or %NULL.
      user_data - user data passed to @callback.
    • ejectWithOperationFinish

      public boolean ejectWithOperationFinish(@Nonnull AsyncResult result) throws AllocationError
      Finishes ejecting a mount. If any errors occurred during the operation,
      @error will be set to contain the errors and %FALSE will be returned.
      Parameter:
      result - a #GAsyncResult.
      Gibt zurück:
      %TRUE if the mount was successfully ejected. %FALSE otherwise.
      Löst aus:
      AllocationError
    • getDefaultLocation

      public File getDefaultLocation()
      Gets the default location of @mount. The default location of the given
      @mount is a path that reflects the main entry point for the user (e.g.
      the home directory, or the root of the volume).
      Gibt zurück:
      a #GFile. The returned object should be unreffed with g_object_unref() when no longer needed.
    • getDrive

      public Drive getDrive()
      Gets the drive for the @mount.

      This is a convenience method for getting the #GVolume and then
      using that object to get the #GDrive.
      Gibt zurück:
      a #GDrive or %NULL if @mount is not associated with a volume or a drive. The returned object should be unreffed with g_object_unref() when no longer needed.
    • getIcon

      public Icon getIcon()
      Gets the icon for @mount.
      Gibt zurück:
      a #GIcon. The returned object should be unreffed with g_object_unref() when no longer needed.
    • getName

      public Str getName()
      Gets the name of @mount.
      Gibt zurück:
      the name for the given @mount. The returned string should be freed with g_free() when no longer needed.
    • getRoot

      public File getRoot()
      Gets the root directory on @mount.
      Gibt zurück:
      a #GFile. The returned object should be unreffed with g_object_unref() when no longer needed.
    • getSortKey

      public Str getSortKey()
      Gets the sort key for @mount, if any.
      Gibt zurück:
      Sorting key for @mount or %NULL if no such key is available.
    • getSymbolicIcon

      public Icon getSymbolicIcon()
      Gets the symbolic icon for @mount.
      Gibt zurück:
      a #GIcon. The returned object should be unreffed with g_object_unref() when no longer needed.
    • getUuid

      public Str getUuid()
      Gets the UUID for the @mount. The reference is typically based on
      the file system UUID for the mount in question and should be
      considered an opaque string. Returns %NULL if there is no UUID
      available.
      Gibt zurück:
      the UUID for @mount or %NULL if no UUID can be computed. The returned string should be freed with g_free() when no longer needed.
    • getVolume

      public Volume getVolume()
      Gets the volume for the @mount.
      Gibt zurück:
      a #GVolume or %NULL if @mount is not associated with a volume. The returned object should be unreffed with g_object_unref() when no longer needed.
    • guessContentType

      public void guessContentType(boolean force_rescan, @Nullable Cancellable cancellable, Mount.OnAsyncReadyCallback callback, @Nullable Pointer user_data)
      Tries to guess the type of content stored on @mount. Returns one or
      more textual identifiers of well-known content types (typically
      prefixed with "x-content/"), e.g. x-content/image-dcf for camera
      memory cards. See the
      [shared-mime-info](http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec)
      specification for more on x-content types.

      This is an asynchronous operation (see
      g_mount_guess_content_type_sync() for the synchronous version), and
      is finished by calling g_mount_guess_content_type_finish() with the
      @mount and #GAsyncResult data returned in the @callback.
      Parameter:
      force_rescan - Whether to force a rescan of the content. Otherwise a cached result will be used if available
      cancellable - optional #GCancellable object, %NULL to ignore
      callback - a #GAsyncReadyCallback
      user_data - user data passed to @callback
    • isShadowed

      public boolean isShadowed()
      Determines if @mount is shadowed. Applications or libraries should
      avoid displaying @mount in the user interface if it is shadowed.

      A mount is said to be shadowed if there exists one or more user
      visible objects (currently #GMount objects) with a root that is
      inside the root of @mount.

      One application of shadow mounts is when exposing a single file
      system that is used to address several logical volumes. In this
      situation, a #GVolumeMonitor implementation would create two
      #GVolume objects (for example, one for the camera functionality of
      the device and one for a SD card reader on the device) with
      activation URIs `gphoto2://[usb:001,002]/store1/`
      and `gphoto2://[usb:001,002]/store2/`. When the
      underlying mount (with root
      `gphoto2://[usb:001,002]/`) is mounted, said
      #GVolumeMonitor implementation would create two #GMount objects
      (each with their root matching the corresponding volume activation
      root) that would shadow the original mount.

      The proxy monitor in GVfs 2.26 and later, automatically creates and
      manage shadow mounts (and shadows the underlying mount) if the
      activation root on a #GVolume is set.
      Gibt zurück:
      %TRUE if @mount is shadowed.
    • remount

      public void remount(int flags, @Nullable MountOperation mount_operation, @Nullable Cancellable cancellable, Mount.OnAsyncReadyCallback callback, @Nullable Pointer user_data)
      Remounts a mount. This is an asynchronous operation, and is
      finished by calling g_mount_remount_finish() with the @mount
      and #GAsyncResults data returned in the @callback.

      Remounting is useful when some setting affecting the operation
      of the volume has been changed, as these may need a remount to
      take affect. While this is semantically equivalent with unmounting
      and then remounting not all backends might need to actually be
      unmounted.
      Parameter:
      flags - flags affecting the operation
      mount_operation - a #GMountOperation or %NULL to avoid user interaction.
      cancellable - optional #GCancellable object, %NULL to ignore.
      callback - a #GAsyncReadyCallback, or %NULL.
      user_data - user data passed to @callback.
    • remountFinish

      public boolean remountFinish(@Nonnull AsyncResult result) throws AllocationError
      Finishes remounting a mount. If any errors occurred during the operation,
      @error will be set to contain the errors and %FALSE will be returned.
      Parameter:
      result - a #GAsyncResult.
      Gibt zurück:
      %TRUE if the mount was successfully remounted. %FALSE otherwise.
      Löst aus:
      AllocationError
    • shadow

      public void shadow()
      Increments the shadow count on @mount. Usually used by
      #GVolumeMonitor implementations when creating a shadow mount for
      @mount, see g_mount_is_shadowed() for more information. The caller
      will need to emit the #GMount::changed signal on @mount manually.
    • unmount

      @Deprecated public void unmount(int flags, @Nullable Cancellable cancellable, Mount.OnAsyncReadyCallback callback, @Nullable Pointer user_data)
      Veraltet.
      Unmounts a mount. This is an asynchronous operation, and is
      finished by calling g_mount_unmount_finish() with the @mount
      and #GAsyncResult data returned in the @callback.
      Parameter:
      flags - flags affecting the operation
      cancellable - optional #GCancellable object, %NULL to ignore.
      callback - a #GAsyncReadyCallback, or %NULL.
      user_data - user data passed to @callback.
    • unmountFinish

      @Deprecated public boolean unmountFinish(@Nonnull AsyncResult result) throws AllocationError
      Veraltet.
      Finishes unmounting a mount. If any errors occurred during the operation,
      @error will be set to contain the errors and %FALSE will be returned.
      Parameter:
      result - a #GAsyncResult.
      Gibt zurück:
      %TRUE if the mount was successfully unmounted. %FALSE otherwise.
      Löst aus:
      AllocationError
    • unmountWithOperation

      public void unmountWithOperation(int flags, @Nullable MountOperation mount_operation, @Nullable Cancellable cancellable, Mount.OnAsyncReadyCallback callback, @Nullable Pointer user_data)
      Unmounts a mount. This is an asynchronous operation, and is
      finished by calling g_mount_unmount_with_operation_finish() with the @mount
      and #GAsyncResult data returned in the @callback.
      Parameter:
      flags - flags affecting the operation
      mount_operation - a #GMountOperation or %NULL to avoid user interaction.
      cancellable - optional #GCancellable object, %NULL to ignore.
      callback - a #GAsyncReadyCallback, or %NULL.
      user_data - user data passed to @callback.
    • unmountWithOperationFinish

      public boolean unmountWithOperationFinish(@Nonnull AsyncResult result) throws AllocationError
      Finishes unmounting a mount. If any errors occurred during the operation,
      @error will be set to contain the errors and %FALSE will be returned.
      Parameter:
      result - a #GAsyncResult.
      Gibt zurück:
      %TRUE if the mount was successfully unmounted. %FALSE otherwise.
      Löst aus:
      AllocationError
    • unshadow

      public void unshadow()
      Decrements the shadow count on @mount. Usually used by
      #GVolumeMonitor implementations when destroying a shadow mount for
      @mount, see g_mount_is_shadowed() for more information. The caller
      will need to emit the #GMount::changed signal on @mount manually.
    • onChanged

      public SignalHandler onChanged(Mount.OnChanged signal)
      Connect to signal "changed".
      See Mount.OnChanged.onChanged() for signal description.
      Field SIGNAL_ON_CHANGED contains original signal name and can be used as resource reference.
      Parameter:
      signal - callback function (lambda).
      Gibt zurück:
      SignalHandler. Can be used to disconnect signal and to release callback function.
    • onPreUnmount

      public SignalHandler onPreUnmount(Mount.OnPreUnmount signal)
      Connect to signal "pre-unmount".
      See Mount.OnPreUnmount.onPreUnmount() for signal description.
      Field SIGNAL_ON_PRE_UNMOUNT contains original signal name and can be used as resource reference.
      Parameter:
      signal - callback function (lambda).
      Gibt zurück:
      SignalHandler. Can be used to disconnect signal and to release callback function.
    • onUnmounted

      public SignalHandler onUnmounted(Mount.OnUnmounted signal)
      Connect to signal "unmounted".
      See Mount.OnUnmounted.onUnmounted() for signal description.
      Field SIGNAL_ON_UNMOUNTED contains original signal name and can be used as resource reference.
      Parameter:
      signal - callback function (lambda).
      Gibt zurück:
      SignalHandler. Can be used to disconnect signal and to release callback function.
    • getTypeID

      public static long getTypeID()
    • getParentTypeID

      public static long getParentTypeID()
    • getTypeSize

      public static TypeSystem.TypeSize getTypeSize()
    • getParentTypeSize

      public static TypeSystem.TypeSize getParentTypeSize()
    • getInstanceSize

      public static int getInstanceSize()