Interface FileMonitor.OnChanged

Enclosing class:
FileMonitor
Functional Interface:
This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface public static interface FileMonitor.OnChanged
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    onChanged(File file, File other_file, int event_type)
    Emitted when @file has been changed.
  • Method Details

    • onChanged

      void onChanged(@Nonnull File file, @Nullable File other_file, int event_type)
      Emitted when @file has been changed.

      If using %G_FILE_MONITOR_WATCH_MOVES on a directory monitor, and
      the information is available (and if supported by the backend),
      @event_type may be %G_FILE_MONITOR_EVENT_RENAMED,
      %G_FILE_MONITOR_EVENT_MOVED_IN or %G_FILE_MONITOR_EVENT_MOVED_OUT.

      In all cases @file will be a child of the monitored directory. For
      renames, @file will be the old name and @other_file is the new
      name. For "moved in" events, @file is the name of the file that
      appeared and @other_file is the old name that it was moved from (in
      another directory). For "moved out" events, @file is the name of
      the file that used to be in this directory and @other_file is the
      name of the file at its new location.

      It makes sense to treat %G_FILE_MONITOR_EVENT_MOVED_IN as
      equivalent to %G_FILE_MONITOR_EVENT_CREATED and
      %G_FILE_MONITOR_EVENT_MOVED_OUT as equivalent to
      %G_FILE_MONITOR_EVENT_DELETED, with extra information.
      %G_FILE_MONITOR_EVENT_RENAMED is equivalent to a delete/create
      pair. This is exactly how the events will be reported in the case
      that the %G_FILE_MONITOR_WATCH_MOVES flag is not in use.

      If using the deprecated flag %G_FILE_MONITOR_SEND_MOVED flag and @event_type is
      %G_FILE_MONITOR_EVENT_MOVED, @file will be set to a #GFile containing the
      old path, and @other_file will be set to a #GFile containing the new path.

      In all the other cases, @other_file will be set to #NULL.
      Parameters:
      file - a #GFile.
      other_file - a #GFile or #NULL.
      event_type - a #GFileMonitorEvent.