Thunarx.PropertyPageProvider: thunarx-python Reference Manual

## Thunarx.PropertyPageProvider Thunarx.PropertyPageProvider — Thunarx.PropertyPageProvider Reference |

## Synopsis

     Thunarx.PropertyPageProvider {
      get_pages(files);
    }

## Description

To add a property page to the file properties dialog, extensions must implement the ThunarxPropertyPageProvider interface. This interface has only one virtual method, get_pages, that is passed a list of Thunarx.FileInfo objects and returns a list of Thunarx.PropertyPage objects.

Example 4. A Thunarx.PropertyPageProvider plugin

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    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 GObject, Gtk, Thunarx

    class ThunarxPropertyPagePlugin(GObject.GObject, Thunarx.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:])

            hbox = Gtk.HBox(0, False)
            hbox.show()

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

            value_label = Gtk.Label()
            hbox.pack_start(value_label, True, True, 0)

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

            page = Thunarx.PropertyPage()
            page.set_label("MD5")
            page.add(hbox)

            return [page]

## Passive Methods

### Thunarx.PropertyPageProvider.get_pages

    get_pages(files);

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

This function is called by Thunar 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.