GtkAda User’s Guide

• 1. Introduction: What is GtkAda ?
• 2. Getting started with GtkAda
  • 2.1. How to build and install GtkAda
  • 2.2. How to distribute a GtkAda application
  • 2.3. How to use GtkAda
  • 2.4. Organization of the GtkAda package
  • 2.5. How to compile an application with GtkAda
  • 2.6. Architecture of the toolkit
  • 2.7. Widgets Hierarchy
• 3. Transitioning from GtkAda 3 to GtkAda 4
• 4. Hierarchical composition of a window
• 5. Signal handling
  • 5.1. Predefined signals
  • 5.2. Connecting signals
    • 5.2.1. Connecting via the On_* procedures
    • 5.2.2. Connecting via the Gtk.Handlers package
  • 5.3. Handling user data
    • 5.3.1. First case: simple user data
    • 5.3.2. Second case: using Object_Connect instead
    • 5.3.3. Third case: manually disconnecting the callback
    • 5.3.4. Fourth case: setting a watch on a specific widget
• 6. Starting an application with GtkAda
  • 6.1. The main procedure
  • 6.2. Creating the main window
  • 6.3. Ending the application
  • 6.4. Startup and shutdown
  • 6.5. Command line and single instance
• 7. Resource files
• 8. Memory management
• 9. Tasking with GtkAda
• 10. Processing external events
• 11. Object-oriented features
  • 11.1. General description of the tagged types
    • 11.1.1. Why should I use object-oriented programming ?
    • 11.1.2. Type conversions from C to Ada widgets
  • 11.2. Using tagged types to extend GTK widgets
  • 11.3. Creating new widgets in Ada
    • 11.3.1. Creating composite widgets
    • 11.3.2. Creating widgets from scratch
• 12. Binding new widgets
• 13. Debugging GtkAda applications
• 14. How to report bugs
• 15. System Package Dependencies
  • 15.1. Red Hat Enterprise Linux 7 & 8
  • 15.2. Red Hat Enterprise Linux 9
  • 15.3. Ubuntu 18.04 & 20.04
• 16. Using GtkParasite to inspect and modify running GtkAda applications
• 17. Bibliography

Appendices

• Transitioning from GtkAda 2 to GtkAda 3
  • General
    • Interfaces
    • Ada 2012
  • Pango
    • Pango.Font
  • Glib
    • Glib.Object
    • Glib.G_Icon
  • Gdk
    • Gdk.Bitmap
    • Gdk.Color
    • Gdk.Cursor
    • Gdk.Dnd
    • Gdk.Drawable
    • Gdk.Event
    • Gdk.Font
    • Gdk.GC
    • Gdk.Image
    • Gdk.Main
    • Gdk.Pixbuf
    • Gdk.Pixmap
    • Gdk.Region
    • Gdk.RGB
    • Gdk.Window
    • Gdk.Window_Attr
  • Gtk
    • Gtk.Action
    • Gtk.Aspect_Frame
    • Gtk.Assistant
    • Gtk.Builder
    • Gtk.Button_Box
    • Gtk.Cell_Layout
    • Gtk.Cell_Renderer
    • Gtk.Cell_View
    • Gtk.Clist
    • Gtk.Container
    • Gtk.Color_Button
    • Gtk.Color_Selection
    • Gtk.Color_Selection_Dialog
    • Gtk.Combo
    • Gtk.Combo_Box
    • Gtk.Combo_Box_Entry
    • Gtk.Clipboard
    • Gtk.Ctree
    • Gtk.Curve
    • Gtk.Dialog
    • Gtk.Dnd
    • Gtk.Editable
    • Gtk.Entry_Completion
    • Gtk.Enums
    • Gtk.File_Chooser_Button
    • Gtk.File_Chooser_Dialog
    • Gtk.File_Chooser_Widget
    • Gtk.File_Selection
    • Gtk.Fixed
    • Gtk.Gamma_Curve
    • Gtk.GC
    • Gtk.GEntry
    • Gtk.GRange
    • Gtk.Handle_Box
    • Gtk.HRuler
    • Gtk.Icon_Factory
    • Gtk.Image
    • Gtk.Image_Menu_Item
    • Gtk.Input_Dialog
    • Gtk.Item
    • Gtk.Item_Factory
    • Gtk.Layout
    • Gtk.Link_Button
    • Gtk.List_Item
    • Gtk.Main
    • Gtk.Menu
    • Gtk.Menu_Item
    • Gtk.Menu_Tool_Button
    • Gtk.Notebook
    • Gtk.List
    • Gtk.Object
    • Gtk.Old_Editable
    • Gtk.Option_Menu
    • Gtk.Pixmap
    • Gtk.Preview
    • Gtk.Print_Operation
    • Gtk.Progress
    • Gtk.Progress_Bar
    • Gtk.Rc
    • Gtk.Recent_Manager
    • Gtk.Ruler
    • Gtk.Settings
    • Gtk.Scale_Button
    • Gtk.Selection
    • Gtk.Scrolled_Window
    • Gtk.Socket / Gtk.Plug
    • Gtk.Status_Icon
    • Gtk.Style
    • Gtk.Text
    • Gtk.Text_Attributes
    • Gtk.Text_View
    • Gtk.Tree_Dnd
    • Gtk.Tree_Model
    • Gtk.Tree_View_Column
    • Gtk.Tips_Query
    • Gtk.Tool_Item
    • Gtk.Toolbar
    • Gtk.Tooltips
    • Gtk.Tree_View
    • Gtk.VRuler
    • Gtk.Widget
    • Gtk.Window
  • GtkAda
    • Gtkada.MDI
    • Gtkada.Properties
  • Gnome
    • Gnome.App_Bar
    • Gnome.Gentry
• GNU Free Documentation License
  • PREAMBLE
  • APPLICABILITY AND DEFINITIONS
  • VERBATIM COPYING
  • COPYING IN QUANTITY
  • MODIFICATIONS
  • COMBINING DOCUMENTS
  • COLLECTIONS OF DOCUMENTS
  • AGGREGATION WITH INDEPENDENT WORKS
  • TRANSLATION
  • TERMINATION
  • FUTURE REVISIONS OF THIS LICENSE
  • ADDENDUM: How to use this License for your documents

Copyright C 1998-2000, Emmanuel Briot, Joel Brobecker, Arnaud Charlet

Copyright C 2000-2026, AdaCore

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled ‘GNU Free Documentation License’.