RecentInfo

 

RecentInfo

class gtk.RecentInfo

gtk.RecentInfo repräsentiert einen Eintrag in der Liste der zuletzt geöffneten Dateien und wird von gtk.RecentManager.lookup_item() zurückgegeben.

Jeder Eintrag enthält

  • Eine URI, die auf die betreffende Datei verweist (es können natürlich auch URIs verwendet werden, die nicht auf Dateien, sondern auf andere Informationen verweisen. Der Einfachheit halber werde ich im Folgenden aber immer von Dateien sprechen).
  • Eine kurze Beschreibung der Datei
  • Der MIME-Typ der Datei
  • Eine Liste von Gruppen, zu denen der Eintrag gehört. Die Gruppen sind einfache Strings und haben keine standardisierte Bedeutung.
  • Eine Liste von Programmen, die einen Eintrag für diese Datei hinzugefügt haben
  • Eine Markierung privat, die angibt, ob die Datei auch mit Programmen geöffnet werden kann, die bisher keinen Eintrag für diese Datei hinzugefügt haben. Diese Markierung ist rein informativ, ihre Beachtung wird nicht erzwungen.

Wichtige Signale

gtk.RecentInfo stellt keine Signale zur Verfügung.

Wichtige Methoden

get_uri()
Rückgabe:URI

Gibt die URI der Datei zurück

get_description()
Rückgabe:Beschreibung

Gibt die Beschreibung zurück

get_mime_type()
Rückgabe:MIME-Typ

Gibt den MIME-Typ zurück

get_added()
Rückgabe:Zeitstempel

Gibt den Zeitstempel zurück, an dem die Datei der Liste hinzugefügt wurde. Die Angabe erfolgt in Unixzeit (“Epoch”), d.h. Sekunden seit dem 1. Januar 1970 00:00 Uhr UTC. Sie können diese Angabe z.B. mit datetime.fromtimestamp() benutzen.

get_modified()
Rückgabe:Zeitstempel

Gibt den Zeitstempel zurück, an dem der Listeneintrag zuletzt geändert wurde. Die Angabe erfolgt in Unixzeit (“Epoch”), d.h. Sekunden seit dem 1. Januar 1970 00:00 Uhr UTC. Sie können diese Angabe z.B. mit datetime.fromtimestamp() benutzen.

get_age()
Rückgabe:Zeit in Tagen

Gibt die Anzahl der Tage seit der letzten Veränderung des Listeneintrags zurück

get_visited()
Rückgabe:Zeitstempel

Gibt den Zeitstempel zurück, an dem der Listeneintrag zuletzt besucht wurde. Die Angabe erfolgt in Unixzeit (“Epoch”), d.h. Sekunden seit dem 1. Januar 1970 00:00 Uhr UTC. Sie können diese Angabe z.B. mit datetime.fromtimestamp() benutzen.

get_private_hint()
Rückgabe:True, falls dieser Eintrag als privat markiert ist, andernfalls False.

Prüft, ob dieser Eintrag als privat markiert ist. Diese Markierung gibt an, ob die Datei auch mit Programmen geöffnet werden kann, die bisher keinen Eintrag für diese Datei hinzugefügt haben. Diese Markierung ist rein informativ, ihre Beachtung wird nicht erzwungen.

get_application_info(app_name)
Parameter:app_name – Name eines Programms
Rückgabe:Tupel, falls app_name mit diesem Eintrag benutzt wurde, andernfalls None

Gibt Informationen über ein Programm zurück, das mit diesem Eintrag benutzt wurde. Das zurückgegebene Tupel enthält drei Werte:

  1. Kommandozeilenbefehl, mit dem das Programm gestartet werden kann
  2. Zahl, wie oft das Programm mit diesem Eintrag benutzt wurde
  3. Zeitstempel, wann das Programm zuletzt mit diesem Eintrag benutzt wurde

Mit get_applications() erhalten Sie eine Liste der mit diesem Eintrag benutzten Programme

get_applications()
Rückgabe:Liste der Programme

Gibt eine liste der mit diesem Eintrag benutzten Programme zurück. Mit get_application_info() können Sie mehr Informationen zu einem Programm erhalten.

last_application()
Rückgabe:Name eines Programms

Gibt den Name des Programms zurück, mit dem dieser Eintrag zuletzt benutzt wurde. Mit get_application_info() können Sie mehr Informationen zu diesem Programm erhalten.

has_application(app_name)
Parameter:app_name – Name eines Programms
Rückgabe:True, falls das Programm mit diesem Eintrag benutzt wurde, andernfalls False

Prüft, ob dieser Eintrag mit einem bestimmten Programm benutzt wurde.

get_groups()
Rückgabe:Liste der Gruppen

Gibt die Liste der Gruppen zurück, zu denen der Eintrag gehört

has_group(group_name)
Parameter:group_name – Name einer Gruppe
Rückgabe:True, falls der Eintrag zur Gruppe group_name gehört, andernfalls False

Prüft, ob der Eintrag zu einer bestimmten Gruppe gehört

get_icon(size)
Parameter:size – Größe des Symbols
Rückgabe:Instanz von gtk.gdk.Pixbuf, die das Symbol enthält oder None

Gibt das für den MIME-Typ der Datei verwendete Symbol mit der Größe size zurück.

get_short_name()
Rückgabe:Name

Gibt den Namen der Datei als UTF-8-kodierten String zurück.

get_uri_display()
Rückgabe:anzeigbare URI

Gibt eine Version der URI der Datei zurück, die zur Anzeige für den Benutzer gedacht ist.

is_local()
Rückgabe:True falls die Datei lokal ist, False andernfalls

Prüft anhand des URI-Schemas, ob die Datei lokal ist.

exists()
Rückgabe:True, falls die Datei noch existiert, andernfalls False

Prüft, ob die Datei noch existiert. Diese Prüfung funktioniert nur bei lokalen Dateien.

Beispiel

1