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.