GTK::Simple
image https://github.com/finanalyst/GTK-Simple/actions/workflows/test.yaml/badge.svg not found
GTK::Simple
GTK::Simple is a set of simple GTK 3 bindings using NativeCall. Only some GTK widgets are currently implemented. However, these are enough to create a reasonable interactive GUI for an idiomatic Raku program. The GTK Widgets in this distribution include the following:
| Widget | Description |
| Button | A simple button with a label and a callback |
| ComboBoxText | A simple combo box |
| Entry | Allows for text to be provided by the user |
| FileChooserButton | A button that opens a file chooser dialog |
| Frame | A bin with a decorative frame and optional label |
| Grid | A table-like container for widgets for window design |
| Label | Adds a line of text |
| LevelBar | A bar that can used as a level indicator |
| LinkButton | Create buttons bound to a URL |
| MarkUpLabel | Adds text with GTK mark up (e.g. color and font manipulation) |
| Menu | A simple menu with a menu item label |
| MenuBar | A simple menu bar that contain one or more menus |
| MenuItem | A simple menu item that can have a sub menu |
| MenuToolButton | A menu tool button with a label or an icon |
| PlacesSidebar | Sidebar that displays frequently-used places in the file system |
| Scale | Allows for a number to be provided by the user |
| ScrolledWindow | Container for widgets needing scrolling, eg., multiline texts |
| RadioButton | A choice from multiple check buttons |
| Spinner | Showing that something is happening |
| TextView | Adds multiple lines of text |
| Toolbar | A tool bar that can contain one or more menu tool buttons |
| VBox, HBox | Widget containers which enable window layout design |
Example
use GTK::Simple;
use GTK::Simple::App;
my $app = GTK::Simple::App.new( title => "Hello GTK!" );
$app.set-content(
GTK::Simple::VBox.new(
my $button = GTK::Simple::Button.new(label => "Hello World!"),
my $second = GTK::Simple::Button.new(label => "Goodbye!")
)
);
$app.border-width = 20;
$second.sensitive = False;
$button.clicked.tap({ .sensitive = False; $second.sensitive = True });
$second.clicked.tap({ $app.exit; });
$app.run;The first four examples were written as mini tutorials to show how the system works:
For more examples, please see the examples/ folder.
Limitations
The full functionality of GTK 3 is not available in this module.
Prerequisites
This module requires the GTK3 library to be installed. Please follow the instructions below based on your platform:
Debian Linux
sudo apt-get install libgtk-3-devMac OS X
brew update
brew install gtk+3Windows
The GTK team describes how to do this for Windows at Setting up GTK for Window
Installation and sanity tests
Use the zef package manager
$ zef install GTK::SimpleAuthor
Jonathan Worthington, jnthn on #raku, https://github.com/jnthn/
Contributors
The Raku team
License
The Artistic License 2.0