Lerking/GTK4PythonTutorial
1
0
Fork 0
mirror of https://github.com/Taiko2k/GTK4PythonTutorial.git synced 2026-03-14 20:10:08 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity

Correction pass using GPT5.4

Browse Source
This commit is contained in:
Taiko2k
2026-03-06 11:52:14 +13:00
parent 73e59593f7
commit cd0a720505
4 changed files with 47 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files

58
README.md
View File

@@ -366,39 +366,37 @@ If you were adding a new action icon it would go in `/usr/share/icons/hicolor/sc
## Adding a file chooser ## Adding a file chooser
Here we use [***Gtk.FileDialog***](https://docs.gtk.org/gtk4/class.FileDialog.html) to present an open file dialog to the user. Here we use [***Gtk.FileChooserNative***](https://docs.gtk.org/gtk4/class.FileChooserNative.html) to present an open file dialog to the user. This is a good choice if you want the example to work across older GTK4 releases as well.
```python ```python
self.open_dialog = Gtk.FileDialog.new() self.open_dialog = Gtk.FileChooserNative.new(
self.open_dialog.set_title("Select a File") "Choose a file",
self,
Gtk.FileChooserAction.OPEN,
"_Open",
"_Cancel",
)
self.open_dialog.connect("response", self.open_response)
def show_open_dialog(self, button): def show_open_dialog(self, button):
self.open_dialog.open(self, None, self.open_dialog_open_callback) self.open_dialog.show()
def open_dialog_open_callback(self, dialog, result): def open_response(self, dialog, response):
try: if response == Gtk.ResponseType.ACCEPT:
file = dialog.open_finish(result) file = dialog.get_file()
if file is not None: if file is not None:
print(f"File path is {file.get_path()}") print(f"File path is {file.get_path()}")
# Handle loading file from here # Handle loading file from here
except GLib.Error as error:
print(f"Error opening file: {error.message}")
``` ```
Adding a filter and setting it as the default: Adding a filter:
```python ```python
f = Gtk.FileFilter() f = Gtk.FileFilter()
f.set_name("Image files") f.set_name("Image files")
f.add_mime_type("image/jpeg") f.add_mime_type("image/jpeg")
f.add_mime_type("image/png") f.add_mime_type("image/png")
self.open_dialog.add_filter(f)
filters = Gio.ListStore.new(Gtk.FileFilter) # Create a ListStore with the type Gtk.FileFilter
filters.append(f) # Add the file filter to the ListStore. You could add more.
self.open_dialog.set_filters(filters) # Set the filters for the open dialog
self.open_dialog.set_default_filter(f)
```` ````
@@ -555,9 +553,9 @@ class MyApp(Adw.Application):
self.win = MainWindow(application=app) self.win = MainWindow(application=app)
self.win.present() self.win.present()
def on_open(self, app, files, n_files, hint): def on_open(self, app, files, n_files, hint):
self.on_activate(app) # Adding this because window may not have been created yet with this entry point self.on_activate(app) # Adding this because window may not have been created yet with this entry point
for file in n_files: for file in files:
print("File to open: " + file.get_path()) # How you handle it from here is up to you, I guess print("File to open: " + file.get_path()) # How you handle it from here is up to you, I guess
``` ```
@@ -716,8 +714,7 @@ You can find a list of common cursor names [here](https://docs.gtk.org/gdk4/ctor
We can use: We can use:
```python ```python
app = self.get_application() sm = Adw.StyleManager.get_default()
sm = app.get_style_manager()
sm.set_color_scheme(Adw.ColorScheme.PREFER_DARK) sm.set_color_scheme(Adw.ColorScheme.PREFER_DARK)
``` ```
@@ -774,7 +771,7 @@ Then we create each object and put them in a ListStore. Then from that ListStore
Then we set that selection model as the model for the grid. Then we set that selection model as the model for the grid.
```python ```python
self.ls = Gio.ListStore() self.ls = Gio.ListStore.new(Fruit)
for f in fruits: for f in fruits:
self.ls.append(Fruit(f)) self.ls.append(Fruit(f))
@@ -823,7 +820,9 @@ Any changes to the name will automatically update the display.
To get the selected item in the grid: To get the selected item in the grid:
```python ```python
print(ss.get_selected_item().name) selected_item = ss.get_selected_item()
if selected_item is not None:
print(selected_item.name)
``` ```
To detect when the selected item has changed: To detect when the selected item has changed:
@@ -922,7 +921,7 @@ Fairly straightforward, see [append_border](https://docs.gtk.org/gtk4/method.Sna
# Tip: There are other functions to load image data from in memory pixel data # Tip: There are other functions to load image data from in memory pixel data
rect = Graphene.Rect().__init__(50, 50, texture.get_width(), texture.get_height()) # See warning below rect = Graphene.Rect().init(50, 50, texture.get_width(), texture.get_height()) # See warning below
s.append_texture(texture, rect) s.append_texture(texture, rect)
``` ```
@@ -948,7 +947,7 @@ a basic example of a single line of text:
font.set_size(12 * Pango.SCALE) # todo how do we follow the window scaling factor? font.set_size(12 * Pango.SCALE) # todo how do we follow the window scaling factor?
context = self.get_pango_context() context = self.get_pango_context()
layout = Pango.Layout(context) # Add Pango to your imports. i.e. from gi.repository import Pango layout = Pango.Layout.new(context) # Add Pango to your imports. i.e. from gi.repository import Pango
layout.set_font_description(font) layout.set_font_description(font)
layout.set_text("Example text") layout.set_text("Example text")
@@ -1036,6 +1035,7 @@ Then we can write our app in Python and load the UI using a [Builder](https://do
```python ```python
import sys import sys
from pathlib import Path
import gi import gi
gi.require_version('Gtk', '4.0') gi.require_version('Gtk', '4.0')
gi.require_version('Adw', '1') gi.require_version('Adw', '1')
@@ -1049,7 +1049,7 @@ class MyApp(Adw.Application):
def on_activate(self, app): def on_activate(self, app):
# Create a Builder # Create a Builder
builder = Gtk.Builder() builder = Gtk.Builder()
builder.add_from_file("test.ui") builder.add_from_file(str(Path(__file__).with_name("test.ui")))
# Obtain the button widget and connect it to a function # Obtain the button widget and connect it to a function
button = builder.get_object("button1") button = builder.get_object("button1")
@@ -1086,5 +1086,3 @@ Picture.
Custom Styles. Custom Styles.

6
part1.py
View File

@@ -33,7 +33,7 @@ class MainWindow(Gtk.ApplicationWindow):
super().__init__() super().__init__()
self.name = name self.name = name
self.ls = Gio.ListStore() self.ls = Gio.ListStore.new(Fruit)
for f in fruits: for f in fruits:
self.ls.append(Fruit(f)) self.ls.append(Fruit(f))
@@ -58,7 +58,9 @@ class MainWindow(Gtk.ApplicationWindow):
self.grid1.set_factory(factory) self.grid1.set_factory(factory)
print(ss.get_selected_item().name) selected_item = ss.get_selected_item()
if selected_item is not None:
print(selected_item.name)
def on_selected_items_changed(selection, position, n_items): def on_selected_items_changed(selection, position, n_items):
selected_item = selection.get_selected_item() selected_item = selection.get_selected_item()

20
part2.py
View File

@@ -94,8 +94,13 @@ class MainWindow(Gtk.ApplicationWindow):
self.header.pack_start(self.open_button) self.header.pack_start(self.open_button)
self.open_button.set_icon_name("document-open-symbolic") self.open_button.set_icon_name("document-open-symbolic")
self.open_dialog = Gtk.FileChooserNative.new(title="Choose a file", self.open_dialog = Gtk.FileChooserNative.new(
parent=self, action=Gtk.FileChooserAction.OPEN) "Choose a file",
self,
Gtk.FileChooserAction.OPEN,
"_Open",
"_Cancel",
)
self.open_dialog.connect("response", self.open_response) self.open_dialog.connect("response", self.open_response)
self.open_button.connect("clicked", self.show_open_dialog) self.open_button.connect("clicked", self.show_open_dialog)
@@ -115,7 +120,7 @@ class MainWindow(Gtk.ApplicationWindow):
# Create a new menu, containing that action # Create a new menu, containing that action
menu = Gio.Menu.new() menu = Gio.Menu.new()
menu.append("Do Something", "win.something") # Or you would do app.grape if you had attached the menu.append("Do Something", "win.something") # Or you would do app.something if you had attached the
# action to the application # action to the application
# Create a popover # Create a popover
@@ -166,8 +171,7 @@ class MainWindow(Gtk.ApplicationWindow):
self.cursor_crosshair = Gdk.Cursor.new_from_name("crosshair") self.cursor_crosshair = Gdk.Cursor.new_from_name("crosshair")
self.dw.set_cursor(self.cursor_crosshair) self.dw.set_cursor(self.cursor_crosshair)
app = self.get_application() sm = Adw.StyleManager.get_default()
sm = app.get_style_manager()
sm.set_color_scheme(Adw.ColorScheme.PREFER_DARK) sm.set_color_scheme(Adw.ColorScheme.PREFER_DARK)
custom = Custom() custom = Custom()
@@ -178,7 +182,7 @@ class MainWindow(Gtk.ApplicationWindow):
def show_about(self, action, param): def show_about(self, action, param):
self.about = Gtk.AboutDialog() self.about = Gtk.AboutDialog()
self.about.set_transient_for(self) self.about.set_transient_for(self)
self.about.set_modal(self) self.about.set_modal(True)
self.about.set_authors(["Your Name"]) self.about.set_authors(["Your Name"])
self.about.set_copyright("Copyright 2022 Your Full Name") self.about.set_copyright("Copyright 2022 Your Full Name")
@@ -188,7 +192,7 @@ class MainWindow(Gtk.ApplicationWindow):
self.about.set_version("1.0") self.about.set_version("1.0")
self.about.set_logo_icon_name("org.example.example") self.about.set_logo_icon_name("org.example.example")
self.about.show() self.about.present()
def key_press(self, event, keyval, keycode, state): def key_press(self, event, keyval, keycode, state):
if keyval == Gdk.KEY_q and state & Gdk.ModifierType.CONTROL_MASK: if keyval == Gdk.KEY_q and state & Gdk.ModifierType.CONTROL_MASK:
@@ -216,7 +220,7 @@ class MainWindow(Gtk.ApplicationWindow):
c.set_source_rgb(1, 0, 1) c.set_source_rgb(1, 0, 1)
for x, y in self.blobs: for x, y in self.blobs:
c.arc(x, y, 10, 0, 2 * 3.1215) c.arc(x, y, 10, 0, 2 * 3.1415926)
c.fill() c.fill()
# Draw a line # Draw a line

5
part3.py
View File

@@ -1,4 +1,5 @@
import sys import sys
from pathlib import Path
import gi import gi
gi.require_version('Gtk', '4.0') gi.require_version('Gtk', '4.0')
gi.require_version('Adw', '1') gi.require_version('Adw', '1')
@@ -12,7 +13,7 @@ class MyApp(Adw.Application):
def on_activate(self, app): def on_activate(self, app):
# Create a Builder # Create a Builder
builder = Gtk.Builder() builder = Gtk.Builder()
builder.add_from_file("test.ui") builder.add_from_file(str(Path(__file__).with_name("test.ui")))
# Obtain the button widget and connect it to a function # Obtain the button widget and connect it to a function
button = builder.get_object("button1") button = builder.get_object("button1")
@@ -27,4 +28,4 @@ class MyApp(Adw.Application):
print("Hello") print("Hello")
app = MyApp(application_id="com.example.GtkApplication") app = MyApp(application_id="com.example.GtkApplication")
app.run(sys.argv) app.run(sys.argv)