Widgetmethoden
Clipboard und Auswahl
| Methode | Parameter | Rückgabewert | Beschreibung |
|---|---|---|---|
| w.clipboard_append(text) | text wird ans Clipboard gehängt | - | Hängt gegebenen Text ans Clipboard |
| w.clipboard_clear() | - | - | Löscht den Inhalt vom Clipboard |
| w.selection_clear() | - | - | Entfernt die Auswahlmarkierung (nicht den ausgewählten Text) aus etwa ttk.Edit und co |
| w.selection_get() | - | Text | Gibt den ausgewählten Text zurück, TclError, wenn kein Text markiert wurde |
| w.selection_own() | - | - | Macht w zum Besitzer des ausgewählten Textes |
| w.selection_own_get() | - | Widget | Gibt den Eigentümer des ausgewählten Textes zurück, TclError, wenn kein Text ausgewählt wurde |
Fokus
| Methode | Parameter | Rückgabewert | Beschreibung |
|---|---|---|---|
| w.focus_displayof() | - | Name des Widgets, das den Fokus hat oder None | Gibt den Names des Widgets zurück, das den aktuellen Inputfokus hat |
| w.focus_force() | - | - | w erhält sofort den Inputfokus |
| w.focus_get() | - | Widgets, das den Fokus hat | Gibt das Widgets zurück, das den aktuellen Inputfokus hat |
| w.focus_lastfor() | - | Name des Widgets, das zuletzt den Fokus hatte | Ergibt den Namen des letzten Elementes, das den Fokus hatte oder den Namen des Toplevel-Elementes. Hatte dieses niemals den Fokus, dann wird der Name desjenigen Elementes zurückgegeben, das den Fokus in Zukunft bekommt. |
| w.focus_set() | - | - | Wenn die Anwendung Fokus hat, bekommt w den Fokus. Sonst wird w für den Fokus vorgemerkt |
| w.tk_focusFollowsMouse() | - | - | Fokus folgt Mausbewegung |
| w.tk_focusNext() | - | Widget | Gibt dasjenige Widget zurück, das als nächstes den Fokus erhält |
| w.tk_focusPrev() | - | Widget | Gibt dasjenige Widget zurück, das vorher den Fokus erhalten hätte |
Grab
Maus- und Tastaturgrabbing: Jedes Maus- oder Tastaturereignis wird an das gegrabbte Widget geliefert.
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
| w.grab_current() | Widget oder None | Rückgabe des Widgets, das aktuell den Grab hat |
| w.grab_release() | - | Entfernt grabbing wieder |
| w.grab_set() | - | Ereignisse der Anwendung werden an w deligiert |
| w.grab_set_global() | - | Ereignisse aller Anwendungen werden an w deligiert. Vorsicht |
| w.grab_status() | Grab-Status | 'none': kein Grabbing,
'local': lokales Grabbing oder 'global' |
Konfiguration
| Methode | Parameter | Rückgabewert | Beschreibung |
|---|---|---|---|
| w.cget(option) | Gesetzte option (beispielsweise ('text') für Labels) des Widgets | Aktuell gesetzte Option | Fragt option beim Widget ab |
| w.config(option=wert, …) | Siehe w.configure | ||
| w.configure(option=wert, …) | option=wert Typische Widgetoptionen (optional) | 5-Tupel | Wie w.['option']=wert. Ohne Parameter erhält man alle Optionen des Widgets in der Form: (OptionName, DbName, DbClass, DefaultValue, CurrentValue) mit DbName: dem Datenbanknamen, DbClass: der Datenbankklasse |
| w.keys() | - | Liste mit Optionen von w | Gibt eine Liste aller Optionen von w aus |
Window- und Widgetinformationen
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
| w.winfo_* | Diverse Widget-Methoden, um Positions-, Größen-, Farb- und weitere Verwaltungsangaben abzufragen. Siehe winfo-Beschreibung | |
| w.winfo_children() | Liste | Gibt eine Liste mit Kind-Elementen eines Widgets zurück. |
| w.winfo_height() | Höhe des Fensters | Gibt die Höhe des Fensters zurück. Die korrekte Fenstergröße steht erst nach einem Durchlauf der Ereigniswarteschlange zur Verfügung. |
| w.winfo_pointerxy() | Tupel | Gibt Mausposition zurück |
| w.winfo_toplevel() | Widget | Gibt Toplevel-Fenster,
das w enthält, zurück |
| w.winfo_width() | Breite des Fensters | Gibt die Breite des Fensters zurück. Die korrekte Fenstergröße steht erst nach einem Durchlauf der Ereigniswarteschlange zur Verfügung. |
Zeit
| Methode | Parameter | Rückgabewert | Beschreibung |
|---|---|---|---|
| w.after(zeitMs, callback, *args) | zeitMs Zeit in Millisekunden, callback eine Funktion, die nach der Zeit aufgerufen wird, arg eine Liste von Argumenten, die der callback mitgegeben wird | Eine id, die man beispielsweise zum Stoppen des Timers benutzen kann | Ruft nach der angegebenen Zeit callback auf |
| w.after_cancel(id) | id, wie sie von w.after(…) zurückggeeben wurde | - | Stoppt den Timer |
| w.after_idle(callback, *args) | callback: Funktion, die aufgerufen wird und args Liste von Argumenten der callback | - | Ruft einmalig callback auf, wenn die Event-Warteschlange leer ist |
| w.wait_variable(var) | var zu setzende Variable | - | Wartet, bis der Wert der Variablen var gesetzt wurde, var muss sich dabei nicht ändern |
| w.wait_visibility(widget) | widget auf das gewartet wird | - | Wartet, bis Widget sichtbar wird |
| w.wait_window(widget) | widget auf das gewartet wird | - | Wartet, bis Fenster entfernt (destroy) wurde |
Sonstiges
| Methode | Parameter | Rückgabewert | Beschreibung |
|---|---|---|---|
| w.bell() | - | - | Lässt auf manchen Systemen einen Klang ertönen |
| w.bindtags(tagList=None) | TODO | ||
| w.destroy() | - | - | Entfernt ein Widget und enthaltene Elemente |
| w.identify(x, y) | x, y: Position auf einem Widget | Beschreibung oder leeren String | Gibt Beschreibung eines Elementes an der Stelle zurück oder einen leeren String |
| w.instate(stateSpec, callback=None, *args, **kw) | stateSpec: siehe w.state(…), callback: Callback | Boolean | callback wird aufgerufen, wenn der Widget-State dem stateSpec entspricht. In dem Fall wird auch True zurückgegeben, sonst False. *args und **kw werden der Callback mitgegeben |
| w.nametowidget(name) | name: der Pfad (TCL) des Widgets | Widget | Gibt das Widget aus, das zum Pfad gehört. KeyError, wenn der Pfad nicht gefunden wurde |
| w.register(function) | TODO | ||
| w.state(stateSpec=None) | stateSpec: '!disabled', 'focus', 'pressed', '!pressed', 'selected', … | State eines Widgets | |