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:
- Kommandozeilenbefehl, mit dem das Programm gestartet werden kann
- Zahl, wie oft das Programm mit diesem Eintrag benutzt wurde
- 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 |
|
