lambda (sidebar actions)    :run-last      

The places sidebar emits this signal when it needs to ask the application to pop up a menu to ask the user for which drag action to perform.

lambda (sidebar context dest source)    :run-last      

When the user starts a drag and drop operation and the sidebar needs to ask the application for which drag action to perform, then the sidebar will emit this signal. The application can evaluate the context for customary actions, or it can check the type of the files indicated by source against the possible actions for the destination dest. The drag action to use must be the return value of the signal handler.

lambda (sidebar dest source action)    :run-first      

The places sidebar emits this signal when the user completes a drag and drop operation and one of the sidebar's items is the destination. This item is in the dest, and the source has the list of files that are dropped into it and which should be copied/moved/, and so on, based onc the specified action.

lambda (sidebar mount)    :run-first      

The places sidebar emits this signal when it starts a new operation because the user clicked on some location that needs mounting. In this way the application using the gtk:places-sidebar widget can track the progress of the operation and, for example, show a notification.

lambda (sidebar location flags)    :run-first      

The places sidebar emits this signal when the user selects a location in it. The calling application should display the contents of that location; for example, a file manager should show a list of files in the specified location.

lambda (sidebar container item volume)    :run-first      

The places sidebar emits this signal when the user invokes a contextual popup on one of its items. In the signal handler, the application may add extra items to the menu as appropriate. For example, a file manager may want to add a "Properties" command to the menu.

It is not necessary to store the item for each menu item; during their callbacks, the application can use the gtk:places-sidebar-location function to get the file to which the item refers.

The item argument may be nil in case the selection refers to a volume. In this case, volume will be non-nil. In this case, the calling application will have to the g:object-ref function the volume and keep it around to use it in the callback.

The container and all its contents are destroyed after the user dismisses the popup. The popup is re-created, and thus, this signal is emitted, every time the user activates the contextual menu.

Before 3.18, the container always was a gtk:menu widget, and you were expected to add your items as gtk:menu-item objects. Since 3.18, the popup may be implemented as a gtk:popover widget, in which case container will be something else, for example, a gtk:box widget, to which you may add gtk:model-button widgets or other widgets, such as gtk:entry, gtk:spin-button widgets, and so on. If your application can deal with this situation, you can set populate-all to true to request that this signal is emitted for populating popovers as well.

lambda (sidebar)    :run-first      

The places sidebar emits this signal when it needs the calling application to present an way to connect directly to a network server. For example, the application may bring up a dialog box asking for a URL like sftp://ftp.example.com. It is up to the application to create the corresponding mount by using, for example, g_file_mount_enclosing_volume().

Warning: The "show-connect-to-server" signal has been deprecated since version 3.18 and should not be used in newly written code. Use the "show-other-locations" signal to connect to network servers.

lambda (sidebar)    :run-first      

The places sidebar emits this signal when it needs the calling application to present an way to directly enter a location. For example, the application may bring up a dialog box asking for a URL like http://http.example.com.

lambda (sidebar primary secondary)    :run-first      

The places sidebar emits this signal when it needs the calling application to present an error message. Most of these messages refer to mounting or unmounting media, for example, when a drive cannot be started for some reason.

lambda (sidebar)    :run-first      

The places sidebar emits this signal when it needs the calling application to present a way to show other locations, for example, drives and network access points. For example, the application may bring up a page showing persistent volumes and discovered network addresses.

Warning: The "show-other-locations" signal has been deprecated since version 3.20 and should not be used in newly written code. Use the "show-other-locations-with-flags" signal which includes the open flags in order to allow the user to specify to open in a new tab or window, in a similar way than the "open-location" signal.

lambda (sidebar flags)    :run-first      

The places sidebar emits this signal when it needs the calling application to present a way to show other locations, for example, drives and network access points. For example, the application may bring up a page showing persistent volumes and discovered network addresses.

lambda (sidebar flags)    :run-first      

The places sidebar emits this signal when it needs the calling application to present a way to show the starred files. In GNOME, starred files are implemented by setting the nao:predefined-tag-favorite tag in the tracker database.

lambda (sidebar mount)    :run-first      

The places sidebar emits this signal when it starts a new operation because the user for example ejected some drive or unmounted a mount. In this way the application using the gtk:places-sidebar widget can track the progress of the operation and, for example, show a notification.