Gtkada.Dialogs

Entities

Simple Types

Constants

Subprograms

Description

This package provides a ready to use high level dialog capability.

<group>Windows</group> <see>Gtk.Message_Dialog</see>

Button_Abort

Button_Abort           : constant Message_Dialog_Buttons := 2 ** 5;

Button_All

Button_All             : constant Message_Dialog_Buttons := 2 ** 2;

Button_Cancel

Button_Cancel          : constant Message_Dialog_Buttons := 2 ** 4;

Button_Dont_Show_Again

Button_Dont_Show_Again : constant Message_Dialog_Buttons := 2 ** 9;

Button_Help

Button_Help            : constant Message_Dialog_Buttons := 2 ** 8;

Button_Ignore

Button_Ignore          : constant Message_Dialog_Buttons := 2 ** 7;

Button_No

Button_No              : constant Message_Dialog_Buttons := 2 ** 1;

Button_None

Button_None            : constant Message_Dialog_Buttons := 0;

Button_OK

Button_OK              : constant Message_Dialog_Buttons := 2 ** 3;

Button_Range

type Button_Range is range 0 .. 9;

The range of valid buttons.

Button_Retry

Button_Retry           : constant Message_Dialog_Buttons := 2 ** 6;

Button_Yes

Button_Yes             : constant Message_Dialog_Buttons := 2 ** 0;

Create_Gtk_Dialog

function Create_Gtk_Dialog
  (Msg           : Glib.UTF8_String;
   Dialog_Type   : Message_Dialog_Type := Information;
   Title         : Glib.UTF8_String := "";
   Justification : Gtk_Justification := Justify_Center;
   Parent        : Gtk.Window.Gtk_Window := null;
   Icon_Name     : String := "")
   return Gtk.Dialog.Gtk_Dialog

Convenience function to create a new dialog. This function was introduced in GtkAda 2.0 to provide a compatibility with Message_Dialog, while using the standard Gtk.Dialog. You should add the buttons yourself, through Gtk.Dialog.Gtk_Dialog, and then display the dialog on the screen through Gtk.Dialog.Run. If Icon_Name is specified, this icon will be displayed instead of the default one. As opposed to Message_Dialog, you can provide your own custom buttons if needed.

Parameters
Msg
Dialog_Type
Title
Justification
Parent
Icon_Name
Return Value

Message_Dialog

function Message_Dialog
  (Msg            : Glib.UTF8_String;
   Dialog_Type    : Message_Dialog_Type := Information;
   Buttons        : Message_Dialog_Buttons := Button_OK or Button_Help;
   Default_Button : Message_Dialog_Buttons := Button_OK;
   Help_Msg       : Glib.UTF8_String := "";
   Title          : Glib.UTF8_String := "";
   Justification  : Gtk_Justification := Justify_Center;
   Parent         : Gtk.Window.Gtk_Window := null;
   Icon_Name      : String := "")
   return Message_Dialog_Buttons

Display a message dialog box centered on the mouse. This will create a dialog box containing the specified message. Dialog_Type indicates the purpose of the dialog. Buttons indicates which buttons should appear in the dialog. Help_Msg is the message displayed in a separate dialog box when the help button is pressed while the dialog is displayed. If Help_Msg is null, a dialog containing the message "No help available" will be displayed. In both cases, the dialog displayed will only have a OK button. If Title is null, a default title will be chosen depending on the value of Dialog_Type. If Icon_Name is specified, this icon will be displayed instead of the default one. The dialog will be centered with regards to Parent

This function will return only after the user pressed one of the buttons or deleted the dialog, by running an additional level of main loop. One of the following values will be returned:

Parameters
Msg
Dialog_Type
Buttons
Default_Button
Help_Msg
Title
Justification
Parent
Icon_Name
Return Value

Message_Dialog_Buttons

type Message_Dialog_Buttons is mod 2 ** 32;

Define the set of values a button in a message dialog box can have.

Message_Dialog_Type

type Message_Dialog_Type is
  (Warning,
   Error,
   Information,
   Confirmation,
   Custom
  );

Define the values describing the type of message box. Used by the Message_Dialog function.

Enumeration Literal
Warning

Message box with a yellow exclamation point.

Error

Message box with a red stop sign.

Information

Message box with a blue "i".

Confirmation

Message box with a blue question mark.

Custom