Nautilus.PropertyPageProvider: nautilus-python Reference Manual

## Nautilus.PropertyPageProvider Nautilus.PropertyPageProvider — Nautilus.PropertyPageProvider Reference |

## Synopsis

     Nautilus.PropertyPageProvider {
      get_pages(files);
    }

## Description

If subclassed, Nautilus will request a list of custom property pages that should appear when a user opens the Properties dialog for a file or folder.

Example 6. Nautilus.PropertyPageProvider Example

    import hashlib

    # A way to get unquote working with python 2 and 3
    try:
        from urllib import unquote
    except ImportError:
        from urllib.parse import unquote

    from gi.repository import Nautilus, Gtk, GObject

    class MD5SumPropertyPage(GObject.GObject, Nautilus.PropertyPageProvider):
        def __init__(self):
            pass

        def get_property_pages(self, files):
            if len(files) != 1:
                return

            file = files[0]
            if file.get_uri_scheme() != 'file':
                return

            if file.is_directory():
                return

            filename = unquote(file.get_uri()[7:])

            self.property_label = Gtk.Label('MD5Sum')
            self.property_label.show()

            self.hbox = Gtk.HBox(homogeneous=False, spacing=0)
            self.hbox.show()

            label = Gtk.Label('MD5Sum:')
            label.show()
            self.hbox.pack_start(label, False, False, 0)

            self.value_label = Gtk.Label()
            self.hbox.pack_start(self.value_label, False, False, 0)

            md5sum = hashlib.md5(filename.encode("utf-8")).hexdigest()
            self.value_label.set_text(md5sum)
            self.value_label.show()

            return Nautilus.PropertyPage(name="NautilusPython::md5_sum",
                                         label=self.property_label,
                                         page=self.hbox),

## Passive Methods

### Nautilus.PropertyPageProvider.get_pages

    get_pages();

`files` : | a list of `Nautilus.FileInfo` objects.
Returns : | a list of `Nautilus.PropertyPage` objects

This function is called by Nautilus when it wants property page items from the extension. It is called in the main thread before a property page is shown, so it should return quickly.