package Implements_Buildable is new Glib.Types.Implements (Gtk.Buildable.Gtk_Buildable, Gtk_About_Dialog_Record, Gtk_About_Dialog);
type Gtk_About_Dialog_Record is new Gtk_Dialog_Record with null record;
type Gtk_About_Dialog is access all Gtk_About_Dialog_Record'Class;
Comments_Property : constant Glib.Properties.Property_String;
Copyright_Property : constant Glib.Properties.Property_String;
License_Property : constant Glib.Properties.Property_String;
Logo_Property : constant Glib.Properties.Property_Object;
Logo_Icon_Name_Property : constant Glib.Properties.Property_String;
Program_Name_Property : constant Glib.Properties.Property_String;
Translator_Credits_Property : constant Glib.Properties.Property_String;
Version_Property : constant Glib.Properties.Property_String;
Website_Property : constant Glib.Properties.Property_String;
Website_Label_Property : constant Glib.Properties.Property_String;
Wrap_License_Property : constant Glib.Properties.Property_Boolean;
Signal_Activate_Link : constant Glib.Signal_Name := "activate-link";
procedure Gtk_New
( | About | : out Gtk_About_Dialog); |
procedure Initialize
( | About | : access Gtk_About_Dialog_Record'Class); |
function Get_Type return Glib.GType;
function Get_Artists
( | About | : access Gtk_About_Dialog_Record) return GNAT.Strings.String_List; |
procedure Set_Artists
( | About | : access Gtk_About_Dialog_Record; |
Artists | : GNAT.Strings.String_List); |
function Get_Authors
( | About | : access Gtk_About_Dialog_Record) return GNAT.Strings.String_List; |
procedure Set_Authors
( | About | : access Gtk_About_Dialog_Record; |
Authors | : GNAT.Strings.String_List); |
function Get_Comments
( | About | : access Gtk_About_Dialog_Record) return UTF8_String; |
procedure Set_Comments
( | About | : access Gtk_About_Dialog_Record; |
Comments | : UTF8_String); |
function Get_Copyright
( | About | : access Gtk_About_Dialog_Record) return UTF8_String; |
procedure Set_Copyright
( | About | : access Gtk_About_Dialog_Record; |
Copyright | : UTF8_String); |
function Get_Documenters
( | About | : access Gtk_About_Dialog_Record) return GNAT.Strings.String_List; |
procedure Set_Documenters
( | About | : access Gtk_About_Dialog_Record; |
Documenters | : GNAT.Strings.String_List); |
function Get_License
( | About | : access Gtk_About_Dialog_Record) return UTF8_String; |
procedure Set_License
( | About | : access Gtk_About_Dialog_Record; |
License | : UTF8_String); |
function Get_Logo
( | About | : access Gtk_About_Dialog_Record) return Gdk.Pixbuf.Gdk_Pixbuf; |
procedure Set_Logo
( | About | : access Gtk_About_Dialog_Record; |
Logo | : access Gdk.Pixbuf.Gdk_Pixbuf_Record'Class); |
function Get_Logo_Icon_Name
( | About | : access Gtk_About_Dialog_Record) return UTF8_String; |
procedure Set_Logo_Icon_Name
( | About | : access Gtk_About_Dialog_Record; |
Icon_Name | : UTF8_String); |
function Get_Name
( | About | : access Gtk_About_Dialog_Record) return UTF8_String; |
procedure Set_Name
( | About | : access Gtk_About_Dialog_Record; |
Name | : UTF8_String); |
function Get_Program_Name
( | About | : access Gtk_About_Dialog_Record) return UTF8_String; |
procedure Set_Program_Name
( | About | : access Gtk_About_Dialog_Record; |
Name | : UTF8_String); |
function Get_Translator_Credits
( | About | : access Gtk_About_Dialog_Record) return UTF8_String; |
procedure Set_Translator_Credits
( | About | : access Gtk_About_Dialog_Record; |
Translator_Credits | : UTF8_String); |
function Get_Version
( | About | : access Gtk_About_Dialog_Record) return UTF8_String; |
procedure Set_Version
( | About | : access Gtk_About_Dialog_Record; |
Version | : UTF8_String); |
function Get_Website
( | About | : access Gtk_About_Dialog_Record) return UTF8_String; |
procedure Set_Website
( | About | : access Gtk_About_Dialog_Record; |
Website | : UTF8_String); |
function Get_Website_Label
( | About | : access Gtk_About_Dialog_Record) return UTF8_String; |
procedure Set_Website_Label
( | About | : access Gtk_About_Dialog_Record; |
Website_Label | : UTF8_String); |
function Get_Wrap_License
( | About | : access Gtk_About_Dialog_Record) return Boolean; |
procedure Set_Wrap_License
( | About | : access Gtk_About_Dialog_Record; |
Wrap_License | : Boolean); |
function Set_Email_Hook
( | Func | : Activate_Link_Func; |
Data | : System.Address; | |
Destroy | : Glib.G_Destroy_Notify_Address) return Activate_Link_Func; |
function Set_Url_Hook
( | Func | : Activate_Link_Func; |
Data | : System.Address; | |
Destroy | : Glib.G_Destroy_Notify_Address) return Activate_Link_Func; |
function "+"
( | Widget | : access Gtk_About_Dialog_Record'Class) return Gtk.Buildable.Gtk_Buildable renames Implements_Buildable.To_Interface; |
function "-"
( | Interf | : Gtk.Buildable.Gtk_Buildable) return Gtk_About_Dialog renames Implements_Buildable.To_Object; |
The Gtk_About_Dialog offers a simple way to display information about a program like its logo, name, copyright, website and license. It is also possible to give credits to the authors, documenters, translators and artists who have worked on the program. An about dialog is typically opened when the user selects the About option from the Help menu. All parts of the dialog are optional.
About dialog often contain links and email addresses. Gtk_About_Dialog supports this by offering global hooks, which are called when the user clicks on a link or email address, see Set_Email_Hook and Set_Url_Hook.
Email addresses in the authors, documenters and artists properties are recognized by looking for <user@host>, URLs are recognized by looking for http://url, with url extending to the next space, tab or line break.
To make constructing a Gtk_About_Dialog as convenient as possible, you can use the function gtk_show_about_dialog which constructs and shows a dialog and keeps it around so that it can be shown again.