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
ActionBar	Group multiple buttons and arrange in 'left', 'middle', and 'right'
Button	A simple button with a label and a callback
Calendar	A calendar for selecting a date
CheckButton	A check button with a label
CheckMenuItem	A checkable menu item
ComboBoxText	A simple combo box
DrawingArea	A drawing area (requires the 'Cairo' module)
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
ListBox	A vertical listbox where each row is selectable
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
ProgressBar	Show progress via a filling bar
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 radio buttons
Spinner	Showing that something is happening
TextView	Adds multiple lines of text
ToggleButton	A toggle-able button
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;

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;

Using :subs option

Another approach is to specify :subs on import. This provides subroutine aliases for the constructors of all of the available GTK::Simple widgets, converted from CamelCase to kebab-case.

GTK::Simple::MenuToolButton becomes menu-tool-button, GTK::Simple::ProgressBar becomes progress-bar, etc.

The above example can be equivalently written as:

use GTK::Simple :subs;

my $app = app(title => "Hello GTK!");

$app.set-content(
    v-box(
        my $button1 = button(label => "Hello World"),
        my $button2 = button(label => "Goodbye!")
    )
);

# ...

Further examples

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-dev

Mac OS X

brew update
brew install gtk+3

Windows

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::Simple

Author

Jonathan Worthington, jnthn on #raku, https://github.com/jnthn/

Contributors

The Raku team

License

The Artistic License 2.0

License

finanalyst/GTK-Simple

About

Topics

Resources

License

Stars

Watchers

Forks

Releases

Packages 0

Contributors 28

Languages

Packages