## Documentation

Table of Contents
Class Inheritance Tree
Widget Screenshots
Package groups

## Index

Package: Widget

- Goto spec source

# Description

    package Gtk.Widget is

This widget is the base of the tree for displayable objects. (A displayable object is one which takes up some amount of screen real estate). It provides a common base and interface which actual widgets must adhere to.

This package provides some services which might have been more appropriate in some other packages, but could not because of dependency circularities (there are for instance some functions relating to colors and colormaps).

We have tried to reference these functions in the other packages as well.

Binding from C File version 2.16.6

# Packages

### Widget_List (new Glib.Glist.Generic_List)

    package Widget_List is new Glib.Glist.Generic_List (Gtk_Widget);

### Widget_SList (new Glib.GSlist.Generic_SList)

    package Widget_SList is new Glib.GSlist.Generic_SList (Gtk_Widget);

### Realize_Handling (generic)

Full description

# Classes

### Gtk_Widget_Record

- Goto declaration in source
- Goto full declaration in source

    type Gtk_Widget_Record is new Glib.Object.GObject_Record with private;

#### Ancestors:

Glib.Object.GObject_Record

#### Immediate Children:

Gtk.Calendar.Gtk_Calendar_Record
Gtk.Cell_View.Gtk_Cell_View_Record
Gtk.Container.Gtk_Container_Record
Gtk.Drawing_Area.Gtk_Drawing_Area_Record
Gtk.Editable.Gtk_Editable_Record
Gtk.Extra.Plot.Gtk_Plot_Record
Gtk.Extra.Plot_Data.Gtk_Plot_Data_Record
Gtk.Extra.Sheet.Gtk_Sheet_Child_Record
Gtk.GRange.Gtk_Range_Record
Gtk.Invisible.Gtk_Invisible_Record
Gtk.Marshallers.Return_Marshallers.Base_Type
Gtk.Marshallers.User_Return_Marshallers.Base_Type
Gtk.Marshallers.User_Void_Marshallers.Base_Type
Gtk.Marshallers.Void_Marshallers.Base_Type
Gtk.Misc.Gtk_Misc_Record
Gtk.Old_Editable.Gtk_Old_Editable_Record
Gtk.Preview.Gtk_Preview_Info_Record
Gtk.Preview.Gtk_Preview_Record
Gtk.Progress.Gtk_Progress_Record
Gtk.Ruler.Gtk_Ruler_Record
Gtk.Separator.Gtk_Separator_Record
Gtk.Widget.Widget_Type
Gtkada.MDI.MDI_Window_Record

#### Primitive operations:

Activate

- To API doc
- To spec

Add_Accelerator

- To API doc
- To spec

Add_Events

- To API doc
- To spec

Add_Mnemonic_Label

- To API doc
- To spec

Can_Activate_Accel

- To API doc
- To spec

Child_Notify

- To API doc
- To spec

Class_Path

- To API doc
- To spec

Class_Path_Reversed

- To API doc
- To spec

Create_Pango_Context

- To API doc
- To spec

Create_Pango_Layout

- To API doc
- To spec

Destroy

- To API doc
- To spec

Draw

- To API doc
- To spec

Ensure_Style

- To API doc
- To spec

Error_Bell

- To API doc
- To spec

Flag_Is_Set

- To API doc
- To spec

Flags

- To API doc
- To spec

Freeze_Child_Notify

- To API doc
- To spec

Get_Allocation_Height

- To API doc
- To spec

Get_Allocation_Width

- To API doc
- To spec

Get_Allocation_X

- To API doc
- To spec

Get_Allocation_Y

- To API doc
- To spec

Get_Ancestor

- To API doc
- To spec

Get_Child_Requisition

- To API doc
- To spec

Get_Child_Visible

- To API doc
- To spec

Get_Colormap

- To API doc
- To spec

Get_Composite_Name

- To API doc
- To spec

Get_Direction

- To API doc
- To spec

Get_Events

- To API doc
- To spec

Get_Extension_Events

- To API doc
- To spec

Get_Has_Tooltip

- To API doc
- To spec

Get_Name

- To API doc
- To spec

Get_No_Show_All

- To API doc
- To spec

Get_Pango_Context

- To API doc
- To spec

Get_Parent

- To API doc
- To spec

Get_Parent_Window

- To API doc
- To spec

Get_Pointer

- To API doc
- To spec

Get_Root_Window

- To API doc
- To spec

Get_Size_Request

- To API doc
- To spec

Get_Snapshot

- To API doc
- To spec

Get_State

- To API doc
- To spec

Get_Style

- To API doc
- To spec

Get_Tooltip_Markup

- To API doc
- To spec

Get_Tooltip_Text

- To API doc
- To spec

Get_Tooltip_Window

- To API doc
- To spec

Get_Toplevel

- To API doc
- To spec

Get_Visual

- To API doc
- To spec

Get_Window

- To API doc
- To spec

Glib.Object.Deallocate

- To API doc
- To spec

(Inherited)
Glib.Object.Get_Type

- To API doc
- To spec

(Inherited)
Glib.Object.Notify

- To API doc
- To spec

(Inherited)
Glib.Object.Ref

- To API doc
- To spec

(Inherited)
Glib.Object.Ref_Sink

- To API doc
- To spec

(Inherited)
Glib.Object.Unref

- To API doc
- To spec

(Inherited)
Grab_Default

- To API doc
- To spec

Grab_Focus

- To API doc
- To spec

Has_Screen

- To API doc
- To spec

Hide

- To API doc
- To spec

Hide_All

- To API doc
- To spec

Input_Shape_Combine_Mask

- To API doc
- To spec

Intersect

- To API doc
- To spec

Is_Ancestor

- To API doc
- To spec

Is_Composited

- To API doc
- To spec

Is_Focus

- To API doc
- To spec

Keynav_Failed

- To API doc
- To spec

List_Mnemonic_Labels

- To API doc
- To spec

Map

- To API doc
- To spec

Mnemonic_Activate

- To API doc
- To spec

Modify_Base

- To API doc
- To spec

Modify_Bg

- To API doc
- To spec

Modify_Cursor

- To API doc
- To spec

Modify_Fg

- To API doc
- To spec

Modify_Font

- To API doc
- To spec

Modify_Text

- To API doc
- To spec

Path

- To API doc
- To spec

Path_Reversed

- To API doc
- To spec

Queue_Clear

- To API doc
- To spec

Queue_Clear_Area

- To API doc
- To spec

Queue_Draw

- To API doc
- To spec

Queue_Draw_Area

- To API doc
- To spec

Queue_Resize

- To API doc
- To spec

Queue_Resize_No_Redraw

- To API doc
- To spec

Realize

- To API doc
- To spec

Region_Intersect

- To API doc
- To spec

Remove_Accelerator

- To API doc
- To spec

Remove_Mnemonic_Label

- To API doc
- To spec

Render_Icon

- To API doc
- To spec

Reparent

- To API doc
- To spec

Reset_Rc_Styles

- To API doc
- To spec

Reset_Shapes

- To API doc
- To spec

Restore_Default_Style

- To API doc
- To spec

Send_Expose

- To API doc
- To spec

Set_Accel_Path

- To API doc
- To spec

Set_App_Paintable

- To API doc
- To spec

Set_Child_Visible

- To API doc
- To spec

Set_Colormap

- To API doc
- To spec

Set_Composite_Name

- To API doc
- To spec

Set_Direction

- To API doc
- To spec

Set_Double_Buffered

- To API doc
- To spec

Set_Events

- To API doc
- To spec

Set_Extension_Events

- To API doc
- To spec

Set_Flags

- To API doc
- To spec

Set_Has_Tooltip

- To API doc
- To spec

Set_Name

- To API doc
- To spec

Set_No_Show_All

- To API doc
- To spec

Set_Parent

- To API doc
- To spec

Set_Parent_Window

- To API doc
- To spec

Set_Redraw_On_Allocate

- To API doc
- To spec

Set_Scroll_Adjustments

- To API doc
- To spec

Set_Sensitive

- To API doc
- To spec

Set_Size_Request

- To API doc
- To spec

Set_State

- To API doc
- To spec

Set_Style

- To API doc
- To spec

Set_Tooltip_Markup

- To API doc
- To spec

Set_Tooltip_Text

- To API doc
- To spec

Set_Tooltip_Window

- To API doc
- To spec

Set_UPosition

- To API doc
- To spec

Set_USize

- To API doc
- To spec

Set_Window

- To API doc
- To spec

Shape_Combine_Mask

- To API doc
- To spec

Show

- To API doc
- To spec

Show_All

- To API doc
- To spec

Show_Now

- To API doc
- To spec

Size_Allocate

- To API doc
- To spec

Size_Request

- To API doc
- To spec

Style_Get_Property

- To API doc
- To spec

Thaw_Child_Notify

- To API doc
- To spec

Trigger_Tooltip_Query

- To API doc
- To spec

Unmap

- To API doc
- To spec

Unrealize

- To API doc
- To spec

Unset_Flags

- To API doc
- To spec

# Types

### Gtk_Widget

- Goto declaration in source

    type Gtk_Widget is access all Gtk_Widget_Record'Class;

### Gtk_Requisition

- Goto declaration in source

    type Gtk_Requisition is record
          Width  : Gint;
          Height : Gint;
       end record;

Gtk_Requisition is the desired amount of screen real-estate a widget requests to the server. Its real allocated size might be different. See the section in the GtkAda user guide on how to create new widgets in Ada, and the examples/base_widget directory for an example on how to use this.

### Gtk_Requisition_Access

- Goto declaration in source

    type Gtk_Requisition_Access is access all Gtk_Requisition;

### Gtk_Allocation

- Goto declaration in source

    type Gtk_Allocation is record
          X      : Gint;
          Y      : Gint;
          Width  : Allocation_Int;
          Height : Allocation_Int;
       end record;

Gtk_Allocation indicates a size and position a widget was allocated. See the section in the user guide on how to create new widgets for more information.

### Gtk_Allocation_Access

- Goto declaration in source

    type Gtk_Allocation_Access is access all Gtk_Allocation;

### Size_Allocate_Handler

- Goto declaration in source

    type Size_Allocate_Handler is access procedure
         (Widget : System.Address; Allocation : Gtk_Allocation);

### Expose_Event_Handler

- Goto declaration in source

    type Expose_Event_Handler is access function
         (Widget : System.Address; Event : Gdk.Event.Gdk_Event) return Boolean;

# Constants & Global variables

### In_Destruction

- Goto declaration in source

    In_Destruction : constant := 2 ** 0;

### Floating

- Goto declaration in source

    Floating       : constant := 2 ** 1;

### Reserved_1

- Goto declaration in source

    Reserved_1     : constant := 2 ** 2;

### Reserved_2

- Goto declaration in source

    Reserved_2     : constant := 2 ** 3;

### Toplevel

- Goto declaration in source

    Toplevel         : constant := 2 ** 4;

### No_Window

- Goto declaration in source

    No_Window        : constant := 2 ** 5;

### Realized

- Goto declaration in source

    Realized         : constant := 2 ** 6;

### Mapped

- Goto declaration in source

    Mapped           : constant := 2 ** 7;

### Visible

- Goto declaration in source

    Visible          : constant := 2 ** 8;

### Sensitive

- Goto declaration in source

    Sensitive        : constant := 2 ** 9;

### Parent_Sensitive

- Goto declaration in source

    Parent_Sensitive : constant := 2 ** 10;

### Can_Focus

- Goto declaration in source

    Can_Focus        : constant := 2 ** 11;

### Has_Focus

- Goto declaration in source

    Has_Focus        : constant := 2 ** 12;

### Can_Default

- Goto declaration in source

    Can_Default      : constant := 2 ** 13;

### Has_Default

- Goto declaration in source

    Has_Default      : constant := 2 ** 14;

### Has_Grab

- Goto declaration in source

    Has_Grab         : constant := 2 ** 15;

### Rc_Style

- Goto declaration in source

    Rc_Style         : constant := 2 ** 16;

### Composite_Child

- Goto declaration in source

    Composite_Child  : constant := 2 ** 17;

### No_Reparent

- Goto declaration in source

    No_Reparent      : constant := 2 ** 18;

### App_Paintable

- Goto declaration in source

    App_Paintable    : constant := 2 ** 19;

### Receives_Default

- Goto declaration in source

    Receives_Default : constant := 2 ** 20;

### Double_Buffered

- Goto declaration in source

    Double_Buffered  : constant := 2 ** 21;

### Name_Property

- Goto declaration in source

(Glib.Properties.Property_String)

    Name_Property                  : constant Glib.Properties.Property_String;

### Parent_Property

- Goto declaration in source

(Glib.Properties.Property_Object)

    Parent_Property                : constant Glib.Properties.Property_Object;

### X_Property

- Goto declaration in source

(Glib.Properties.Property_Int)

    X_Property                     : constant Glib.Properties.Property_Int;

### Y_Property

- Goto declaration in source

(Glib.Properties.Property_Int)

    Y_Property                     : constant Glib.Properties.Property_Int;

### Width_Property

- Goto declaration in source

(Glib.Properties.Property_Int)

    Width_Property                 : constant Glib.Properties.Property_Int;

### Height_Property

- Goto declaration in source

(Glib.Properties.Property_Int)

    Height_Property                : constant Glib.Properties.Property_Int;

### Visible_Property

- Goto declaration in source

(Glib.Properties.Property_Boolean)

    Visible_Property               : constant Glib.Properties.Property_Boolean;

### Sensitive_Property

- Goto declaration in source

(Glib.Properties.Property_Boolean)

    Sensitive_Property             : constant Glib.Properties.Property_Boolean;

### App_Paintable_Property

- Goto declaration in source

(Glib.Properties.Property_Boolean)

    App_Paintable_Property         : constant Glib.Properties.Property_Boolean;

### Can_Focus_Property

- Goto declaration in source

(Glib.Properties.Property_Boolean)

    Can_Focus_Property             : constant Glib.Properties.Property_Boolean;

### Has_Focus_Property

- Goto declaration in source

(Glib.Properties.Property_Boolean)

    Has_Focus_Property             : constant Glib.Properties.Property_Boolean;

### Can_Default_Property

- Goto declaration in source

(Glib.Properties.Property_Boolean)

    Can_Default_Property           : constant Glib.Properties.Property_Boolean;

### Has_Default_Property

- Goto declaration in source

(Glib.Properties.Property_Boolean)

    Has_Default_Property           : constant Glib.Properties.Property_Boolean;

### Receives_Default_Property

- Goto declaration in source

(Glib.Properties.Property_Boolean)

    Receives_Default_Property      : constant Glib.Properties.Property_Boolean;

### Composite_Child_Property

- Goto declaration in source

(Glib.Properties.Property_Boolean)

    Composite_Child_Property       : constant Glib.Properties.Property_Boolean;

### Style_Property

- Goto declaration in source

(Glib.Properties.Property_Object)

    Style_Property                 : constant Glib.Properties.Property_Object;

### Events_Property

- Goto declaration in source

(Gdk.Event.Property_Gdk_Event_Mask)

    Events_Property                : constant Gdk.Event.Property_Gdk_Event_Mask;

### Prop_Extensions_Events_Property

- Goto declaration in source

(Gdk.Types.Property_Gdk_Extension_Mode)

    Prop_Extensions_Events_Property :
         constant Gdk.Types.Property_Gdk_Extension_Mode;

### Extension_Events_Property

- Goto declaration in source

(Gdk.Types.Property_Gdk_Extension_Mode)

    Extension_Events_Property  : constant Gdk.Types.Property_Gdk_Extension_Mode;

### Height_Request_Property

- Goto declaration in source

(Glib.Properties.Property_Int)

    Height_Request_Property        : constant Glib.Properties.Property_Int;

### Is_Focus_Property

- Goto declaration in source

(Glib.Properties.Property_Boolean)

    Is_Focus_Property              : constant Glib.Properties.Property_Boolean;

### No_Show_All_Property

- Goto declaration in source

(Glib.Properties.Property_Boolean)

    No_Show_All_Property           : constant Glib.Properties.Property_Boolean;

### Width_Request_Property

- Goto declaration in source

(Glib.Properties.Property_Int)

    Width_Request_Property         : constant Glib.Properties.Property_Int;

### Tooltip_Markup_Property

- Goto declaration in source

(Glib.Properties.Property_String)

    Tooltip_Markup_Property        : constant Glib.Properties.Property_String;

### Tooltip_Text_Property

- Goto declaration in source

(Glib.Properties.Property_String)

    Tooltip_Text_Property          : constant Glib.Properties.Property_String;

### Has_Tooltip_Property

- Goto declaration in source

(Glib.Properties.Property_Boolean)

    Has_Tooltip_Property           : constant Glib.Properties.Property_Boolean;

### Window_Property

- Goto declaration in source

(Glib.Properties.Property_Object)

    Window_Property                : constant Glib.Properties.Property_Object;

### Cursor_Aspect_Ratio_Property

- Goto declaration in source

(Glib.Properties.Property_Float)

    Cursor_Aspect_Ratio_Property  : constant Glib.Properties.Property_Float;

Cursor_Color_Property : constant Glib.Properties.Property_Boxed; Draw_Border_Property : constant Glib.Properties.Property_Boxed;

### Focus_Line_Pattern_Property

- Goto declaration in source

(Glib.Properties.Property_String)

    Focus_Line_Pattern_Property   : constant Glib.Properties.Property_String;

Cursor_Color_Property : constant Glib.Properties.Property_Boxed; Draw_Border_Property : constant Glib.Properties.Property_Boxed;

### Focus_Line_Width_Property

- Goto declaration in source

(Glib.Properties.Property_Int)

    Focus_Line_Width_Property     : constant Glib.Properties.Property_Int;

### Focus_Padding_Property

- Goto declaration in source

(Glib.Properties.Property_Int)

    Focus_Padding_Property        : constant Glib.Properties.Property_Int;

### Interior_Focus_Property

- Goto declaration in source

(Glib.Properties.Property_Boolean)

    Interior_Focus_Property       : constant Glib.Properties.Property_Boolean;

### Link_Color_Property

- Goto declaration in source

(Glib.Properties.Property_Boxed)

    Link_Color_Property           : constant Glib.Properties.Property_Boxed;

### Scroll_Arrow_Hlength_Property

- Goto declaration in source

(Glib.Properties.Property_Int)

    Scroll_Arrow_Hlength_Property : constant Glib.Properties.Property_Int;

### Scroll_Arrow_Vlength_Property

- Goto declaration in source

(Glib.Properties.Property_Int)

    Scroll_Arrow_Vlength_Property : constant Glib.Properties.Property_Int;

Secondary_Cursor_Color_Property : constant Glib.Properties.Property_Boxed;

### Separator_Height_Property

- Goto declaration in source

(Glib.Properties.Property_Int)

    Separator_Height_Property     : constant Glib.Properties.Property_Int;

Secondary_Cursor_Color_Property : constant Glib.Properties.Property_Boxed;

### Separator_Width_Property

- Goto declaration in source

(Glib.Properties.Property_Int)

    Separator_Width_Property      : constant Glib.Properties.Property_Int;

### Visited_Link_Color_Property

- Goto declaration in source

(Glib.Properties.Property_Boxed)

    Visited_Link_Color_Property   : constant Glib.Properties.Property_Boxed;

### Wide_Separators_Property

- Goto declaration in source

(Glib.Properties.Property_Boolean)

    Wide_Separators_Property      : constant Glib.Properties.Property_Boolean;

### Signal_Accel_Closures_Changed

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Accel_Closures_Changed  : constant Glib.Signal_Name :=
                                          "accel_closures_changed";

### Signal_Button_Press_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Button_Press_Event      : constant Glib.Signal_Name :=
                                          "button_press_event";

### Signal_Button_Release_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Button_Release_Event    : constant Glib.Signal_Name :=
                                          "button_release_event";

### Signal_Can_Activate_Accel

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Can_Activate_Accel      : constant Glib.Signal_Name :=
                                          "can_activate_accel";

### Signal_Child_Notify

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Child_Notify            : constant Glib.Signal_Name :=
                                          "child_notify";

### Signal_Client_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Client_Event            : constant Glib.Signal_Name :=
                                          "client_event";

### Signal_Configure_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Configure_Event         : constant Glib.Signal_Name :=
                                          "configure_event";

### Signal_Delete_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Delete_Event            : constant Glib.Signal_Name :=
                                          "delete_event";

### Signal_Destroy

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Destroy                 : constant Glib.Signal_Name :=
                                          "destroy";

### Signal_Destroy_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Destroy_Event           : constant Glib.Signal_Name :=
                                          "destroy_event";

### Signal_Direction_Changed

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Direction_Changed       : constant Glib.Signal_Name :=
                                          "direction_changed";

### Signal_Drag_Begin

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Drag_Begin              : constant Glib.Signal_Name :=
                                          "drag_begin";

### Signal_Drag_Data_Delete

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Drag_Data_Delete        : constant Glib.Signal_Name :=
                                          "drag_data_delete";

### Signal_Drag_Data_Get

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Drag_Data_Get           : constant Glib.Signal_Name :=
                                          "drag_data_get";

### Signal_Drag_Data_Received

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Drag_Data_Received      : constant Glib.Signal_Name :=
                                          "drag_data_received";

### Signal_Drag_Drop

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Drag_Drop               : constant Glib.Signal_Name :=
                                          "drag_drop";

### Signal_Drag_End

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Drag_End                : constant Glib.Signal_Name :=
                                          "drag_end";

### Signal_Drag_Leave

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Drag_Leave              : constant Glib.Signal_Name :=
                                          "drag_leave";

### Signal_Drag_Motion

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Drag_Motion             : constant Glib.Signal_Name :=
                                          "drag_motion";

### Signal_Enter_Notify_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Enter_Notify_Event      : constant Glib.Signal_Name :=
                                          "enter_notify_event";

### Signal_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Event                   : constant Glib.Signal_Name :=
                                          "event";

### Signal_Event_After

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Event_After             : constant Glib.Signal_Name :=
                                          "event-after";

### Signal_Expose_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Expose_Event            : constant Glib.Signal_Name :=
                                          "expose_event";

### Signal_Focus

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Focus                   : constant Glib.Signal_Name :=
                                          "focus";

### Signal_Focus_In_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Focus_In_Event          : constant Glib.Signal_Name :=
                                          "focus_in_event";

### Signal_Focus_Out_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Focus_Out_Event         : constant Glib.Signal_Name :=
                                          "focus_out_event";

### Signal_Grab_Broken_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Grab_Broken_Event       : constant Glib.Signal_Name :=
                                          "grab_broken_event";

### Signal_Grab_Focus

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Grab_Focus              : constant Glib.Signal_Name :=
                                          "grab_focus";

### Signal_Grab_Notify

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Grab_Notify             : constant Glib.Signal_Name :=
                                          "grab_notify";

### Signal_Hide

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Hide                    : constant Glib.Signal_Name :=
                                          "hide";

### Signal_Hierarchy_Changed

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Hierarchy_Changed       : constant Glib.Signal_Name :=
                                          "hierarchy_changed";

### Signal_Key_Press_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Key_Press_Event         : constant Glib.Signal_Name :=
                                          "key_press_event";

### Signal_Key_Release_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Key_Release_Event       : constant Glib.Signal_Name :=
                                          "key_release_event";

### Signal_Leave_Notify_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Leave_Notify_Event      : constant Glib.Signal_Name :=
                                          "leave_notify_event";

### Signal_Map

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Map                     : constant Glib.Signal_Name :=
                                          "map";

### Signal_Map_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Map_Event               : constant Glib.Signal_Name :=
                                          "map_event";

### Signal_Mnemonic_Activate

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Mnemonic_Activate       : constant Glib.Signal_Name :=
                                          "mnemonic_activate";

### Signal_Motion_Notify_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Motion_Notify_Event     : constant Glib.Signal_Name :=
                                          "motion_notify_event";

### Signal_No_Expose_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_No_Expose_Event         : constant Glib.Signal_Name :=
                                          "no_expose_event";

### Signal_Parent_Set

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Parent_Set              : constant Glib.Signal_Name :=
                                          "parent_set";

### Signal_Popup_Menu

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Popup_Menu              : constant Glib.Signal_Name :=
                                          "popup_menu";

### Signal_Property_Notify_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Property_Notify_Event   : constant Glib.Signal_Name :=
                                          "property_notify_event";

### Signal_Proximity_In_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Proximity_In_Event      : constant Glib.Signal_Name :=
                                          "proximity_in_event";

### Signal_Proximity_Out_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Proximity_Out_Event     : constant Glib.Signal_Name :=
                                          "proximity_out_event";

### Signal_Realize

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Realize                 : constant Glib.Signal_Name :=
                                          "realize";

### Signal_Query_Tooltip

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Query_Tooltip           : constant Glib.Signal_Name :=
                                          "query-tooltip";

### Signal_Screen_Changed

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Screen_Changed          : constant Glib.Signal_Name :=
                                          "screen_changed";

### Signal_Scroll_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Scroll_Event            : constant Glib.Signal_Name :=
                                          "scroll_event";

### Signal_Selection_Clear_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Selection_Clear_Event   : constant Glib.Signal_Name :=
                                          "selection_clear_event";

### Signal_Selection_Get

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Selection_Get           : constant Glib.Signal_Name :=
                                          "selection_get";

### Signal_Selection_Notify_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Selection_Notify_Event  : constant Glib.Signal_Name :=
                                          "selection_notify_event";

### Signal_Selection_Received

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Selection_Received      : constant Glib.Signal_Name :=
                                          "selection_received";

### Signal_Selection_Request_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Selection_Request_Event : constant Glib.Signal_Name :=
                                          "selection_request_event";

### Signal_Show

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Show                    : constant Glib.Signal_Name :=
                                          "show";

### Signal_Show_Help

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Show_Help               : constant Glib.Signal_Name :=
                                          "show_help";

### Signal_Size_Allocate

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Size_Allocate           : constant Glib.Signal_Name :=
                                          "size_allocate";

### Signal_Size_Request

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Size_Request            : constant Glib.Signal_Name :=
                                          "size_request";

### Signal_State_Changed

- Goto declaration in source

(Glib.Signal_Name)

    Signal_State_Changed           : constant Glib.Signal_Name :=
                                          "state_changed";

### Signal_Style_Set

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Style_Set               : constant Glib.Signal_Name :=
                                          "style_set";

### Signal_Unmap

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Unmap                   : constant Glib.Signal_Name :=
                                          "unmap";

### Signal_Unmap_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Unmap_Event             : constant Glib.Signal_Name :=
                                          "unmap_event";

### Signal_Unrealize

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Unrealize               : constant Glib.Signal_Name :=
                                          "unrealize";

### Signal_Visibility_Notify_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Visibility_Notify_Event : constant Glib.Signal_Name :=
                                          "visibility_notify_event";

### Signal_Window_State_Event

- Goto declaration in source

(Glib.Signal_Name)

    Signal_Window_State_Event      : constant Glib.Signal_Name :=
                                          "window_state_event";

# Subprograms & Entries

### Get_Type

- Goto spec in source
- Goto body in source

    function Get_Type return Glib.GType;

Return the internal type associated with a Gtk_Widget.

### Requisition_Get_Type

- Goto spec in source
- Goto body in source

    function Requisition_Get_Type return Glib.GType;

Return the internal type for a Gtk_Requisition

### Convert

- Goto spec in source

    function Convert (W: Gtk_Widget) return System.Address;

<doc_ignore>

### Convert

- Goto spec in source

    function Convert (W: System.Address) return Gtk_Widget;

</doc_ignore>

### Destroy

- Goto spec in source

    procedure Destroy (Widget: access Gtk_Widget_Record);

Destroy the widget. This emits a "destroy" signal, calls all your handlers, and then unconnects them all. The object is then unref-ed, and if its reference count goes down to 0, the memory associated with the object and its user data is freed. Note that when you destroy handlers are called, the user_data is still available. When a widget is destroyed, it will break any references it holds to other objects. If the widget is inside a container, the widget will be removed from the container. If the widget is a toplevel (derived from Gtk_Window), it will be removed from the list of toplevels, and the reference GTK+ holds to it will be removed. Removing widget from its container or the list of toplevels results in the widget being finalized, unless you've added additional references to the widget with Ref. In most cases, only toplevel widgets (windows) require explicit destruction, because when you destroy a toplevel its children will be destroyed as well.

### Destroy_Cb

- Goto spec in source

    procedure Destroy_Cb (Widget: access Gtk_Widget_Record'Class);

This function should be used as a callback to destroy a widget. All it does is call Destroy on its argument, but its profile is compatible with the handlers found in Gtk.Handlers.

### Unparent

- Goto spec in source

    procedure Unparent (Widget: access Gtk_Widget_Record'Class);

This function is only for use in widget implementations. Should be called by implementations of the remove method on Gtk_Container, to dissociate a child from the container. Users should call Remove instead. This function might be dangereous: it correctly updates widget to reflect that it no longer belongs to its parent, however the parent keeps an internal pointer to the widget, which will result in a storage_error if you try to further access it.

### Show

- Goto spec in source

    procedure Show (Widget: access Gtk_Widget_Record);

Schedule the widget to be displayed on the screen when its parent is also shown (emits the "show" signal). If its ancestors are already mapped to the screen, then the widget is immediately displayed through a call to Map below.

### Show_Now

- Goto spec in source

    procedure Show_Now (Widget: access Gtk_Widget_Record);

Show the widget. If it is an unmapped toplevel widget, wait for it to be mapped. This creates a recursive main_loop.

### Hide

- Goto spec in source

    procedure Hide (Widget: access Gtk_Widget_Record);

Hide the widget from the screen (emits the "hide" signal). If Widget was visible, it is immediately hidden. If one of its ancestor is later shown on the screen, Widget won't appear. Note that on some window managers, including CDE, hiding an iconified window will not do anything. You should in addition call Gdk.Window.Withdraw to make sure the window is properly hidden.

### Show_All

- Goto spec in source

    procedure Show_All (Widget: access Gtk_Widget_Record);

Show Widget and all its children recursively. See also Set_Child_Visible below

### Hide_All

- Goto spec in source

    procedure Hide_All (Widget: access Gtk_Widget_Record);

Hide Widget and all its children. Note that if you simply want to delete Widget from the screen, you can simply call the Hide subprogram on it. This procedure Hide_All should only be used if you want to unschedule a widget to be displayed later, not to remove an actual widget from the screen. See also Set_Child_Visible below.

### Set_No_Show_All

- Goto spec in source

    procedure Set_No_Show_All (Widget: access Gtk_Widget_Record;No_Show_All: Boolean);

### Get_No_Show_All

- Goto spec in source

    function Get_No_Show_All (Widget: access Gtk_Widget_Record) return Boolean;

Sets the "no_show_all" property, which determines whether calls to Show_All() and Hide_All() will affect this widget. This is mostly for use in constructing widget hierarchies with externally controlled visibility.

### Map

- Goto spec in source

    procedure Map (Widget: access Gtk_Widget_Record);

Map a widget to the screen. A window is created for it on the screen (through a call to Realize) and Widget is then drawn on the screen (if its ancestors are also mapped). This function is recursive and will also map all the children of Widget. It is recommended to use the higher-level Show instead.

### Unmap

- Goto spec in source

    procedure Unmap (Widget: access Gtk_Widget_Record);

Unmap a widget from the screen. This results in the widget being hidden, but not destroyed. It can be shown again any time through a call to Map (provided its ancestors are also mapped). It is recommended to use the higher-level Hide instead.

### Realize

- Goto spec in source

    procedure Realize (Widget: access Gtk_Widget_Record);

Create a window for Widget and its ancestors (emit the "realize" signal) This does not mean that the widget will appear on the screen, but resources such as colormaps, etc. become available. Some routines require that the widget is realized before any call. You must set the Event_Mask before calling this routine if you want to change it from its default value.

### Unrealize

- Goto spec in source

    procedure Unrealize (Widget: access Gtk_Widget_Record);

Hide the widget from the screen and deletes the associated window. This does not destroy the widget itself, only its server-side resources.

### Hide_On_Delete

- Goto spec in source

    function Hide_On_Delete (Widget: access Gtk_Widget_Record'Class) return Boolean;

Hide widget and return True. This function is intended to be used as a callback.

### Set_Child_Visible

- Goto spec in source

    procedure Set_Child_Visible (Widget: access Gtk_Widget_Record;Is_Visible: Boolean);

### Get_Child_Visible

- Goto spec in source

    function Get_Child_Visible (Widget: access Gtk_Widget_Record) return Boolean;

Sets whether Widget should be mapped along with its parent when its parent is mapped and Widget has been shown with Show. "mapped" indicates the moment the window is actually shown on the screen. Show and Hide indicate your intention to show Widget on the scree or not, but if the parent of Widget is itself not shown at that time, the two commands Show and Hide have no immediate effect, and just set a flag to save your intent. Set_Child_Visible indicates that the widget shouldn't be part of the recursive processing done by Show_All and Hide_All on the parent. You have decided once and for all what the behavior should be, and you don't want it to be changed by future calls to Show_All and Hide_All. The child visibility can be set for widget before it is added to a container with Set_Parent, to avoid mapping children unnecessary before immediately unmapping them. However it will be reset to its default state of True when the widget is removed from a container. Note that changing the child visibility of a widget does not queue a resize on the widget. Most of the time, the size of a widget is computed from all visible children, whether or not they are mapped. If this is not the case, the container can queue a resize itself. This function is only useful for container implementations and should generally not be called by an application.

### Has_Screen

- Goto spec in source

    function Has_Screen (Widget: access Gtk_Widget_Record) return Boolean;

Checks whether there is a Gdk_Screen is associated with this widget. All toplevel widgets have an associated screen, and all widgets added into a hierarchy with a toplevel window at the top.

### Queue_Draw

- Goto spec in source

    procedure Queue_Draw (Widget: access Gtk_Widget_Record);

Add a drawing request to the event queue for the whole widget. This is more efficient than calling Draw directly, since GtkAda groups drawing requests as much as possible to speed up the drawing process. The actual drawing will take place as soon as GtkAda is not busy processing other events, but before idle events.

### Queue_Draw_Area

- Goto spec in source

    procedure Queue_Draw_Area (Widget: access Gtk_Widget_Record;X: Gint;Y: Gint;Width: Gint;Height: Gint);

Add a drawing request to the event queue for part of the widget. This is more efficient that calling Draw directly (see Queue_Draw).

### Queue_Resize

- Goto spec in source

    procedure Queue_Resize (Widget: access Gtk_Widget_Record);

Queue drawing requests after a resizing of the widget. This clears the widget, and its parent if any, so that everything is correctly redrawn. You should not have to call this function directly. For a Gtk_Window, check the procedure Gtk.Window.Resize instead.

### Queue_Resize_No_Redraw

- Goto spec in source

    procedure Queue_Resize_No_Redraw (Widget: access Gtk_Widget_Record);

This function works like Queue_Resize(), except that the widget is not invalidated (ie will not be redrawn)

### Create_Pango_Context

- Goto spec in source

    function Create_Pango_Context (Widget: access Gtk_Widget_Record) return Pango.Context.Pango_Context;

Create a new Pango_Context with the appropriate colormap, font description, and base direction for drawing text for this widget. See also Get_Pango_Context. The returned context must be freed by the caller.

### Create_Pango_Layout

- Goto spec in source

    function Create_Pango_Layout (Widget: access Gtk_Widget_Record;Text: UTF8_String := "") return Pango.Layout.Pango_Layout;

Return a new pango_layout that displays Text. This fully handles internationalization, and should be the preferred way to display text, rather than Gdk.Drawable.Draw_Text Text must be a valid Utf8 text, see Glib.Convert.

### Size_Request

- Goto spec in source

    procedure Size_Request (Widget: access Gtk_Widget_Record;Requisition: in out Gtk_Requisition);

Emit a "size_request" event for the widget

### Set_Size_Request

- Goto spec in source

    procedure Set_Size_Request (Widget: access Gtk_Widget_Record;Width, Height: Gint := -1);

### Get_Size_Request

- Goto spec in source

    procedure Get_Size_Request (Widget: access Gtk_Widget_Record;Width, Height: out Gint);

Sets the minimum size of a widget; that is, the widget's size request will be Width by Height. You can use this function to force a widget to be either larger or smaller than it normally would be. In most cases, Set_Default_Size is a better choice for toplevel windows than this function; setting the default size will still allow users to shrink the window. Setting the size request will force them to leave the window at least as large as the size request. When dealing with window sizes, Gtk.Windo.Set_Geometry_Hints can be a useful function as well. Note the inherent danger of setting any fixed size - themes, translations into other languages, different fonts, and user action can all change the appropriate size for a given widget. So, it's basically impossible to hardcode a size that will always be correct. The size request of a widget is the smallest size a widget can accept while still functioning well and drawing itself correctly. However in some strange cases a widget may be allocated less than its requested size, and in many cases a widget may be allocated more space than it requested. If the size request in a given direction is -1 (unset), then the "natural" size request of the widget will be used instead. Widgets can't actually be allocated a size less than 1 by 1, but you can pass 0,0 to this function to mean "as small as possible."

### Size_Allocate

- Goto spec in source

    procedure Size_Allocate (Widget: access Gtk_Widget_Record;Allocation: Gtk_Allocation);

Emit a "size_allocate" event for the widget. Allocation'size is first constrained to a range between 1x1 and 32767x32767. A clear and draw request is also queued if required.

### Get_Child_Requisition

- Goto spec in source

    function Get_Child_Requisition (Widget: access Gtk_Widget_Record) return Gtk_Requisition;

Return the size requests by the widget. This is the ideal size for the widget, not necessarily its actual size. See the user guide's section on how to create new widgets for more information on the size requisition and allocation.

### Get_Allocation_Width

- Goto spec in source

    function Get_Allocation_Width (Widget: access Gtk_Widget_Record) return Allocation_Int;

Return the current width of the widget.

### Get_Allocation_Height

- Goto spec in source

    function Get_Allocation_Height (Widget: access Gtk_Widget_Record) return Allocation_Int;

Return the current height of the widget.

### Get_Allocation_X

- Goto spec in source

    function Get_Allocation_X (Widget: access Gtk_Widget_Record) return Gint;

Return the current position of the widget, relative to its parent.

### Get_Allocation_Y

- Goto spec in source

    function Get_Allocation_Y (Widget: access Gtk_Widget_Record) return Gint;

Return the current position of the widget, relative to its parent.

### Set_Redraw_On_Allocate

- Goto spec in source

    procedure Set_Redraw_On_Allocate (Widget: access Gtk_Widget_Record;Redraw_On_Allocate: Boolean);

Sets whether the entire widget is queued for drawing when its size allocation changes. By default, this setting is %TRUE and the entire widget is redrawn on every size change. If your widget leaves the upper left unchanged when made bigger, turning this setting on will improve performance. Note that for %NO_WINDOW widgets setting this flag to %FALSE turns off all allocation on resizing: the widget will not even redraw if its position changes; this is to allow containers that don't draw anything to avoid excess invalidations. If you set this flag on %NO_WINDOW widget that *does* draw on Get_Window (Widget), you are responsible for invalidating both the old and new allocation of the widget when the widget is moved and responsible for invalidating regions newly when the widget increases size.

### Add_Accelerator

- Goto spec in source

    procedure Add_Accelerator (Widget: access Gtk_Widget_Record;Accel_Signal: Glib.Signal_Name;Accel_Group: Gtk.Accel_Group.Gtk_Accel_Group;Accel_Key: Gdk.Types.Gdk_Key_Type;Accel_Mods: Gdk.Types.Gdk_Modifier_Type;Accel_Flags: Gtk.Accel_Group.Gtk_Accel_Flags);

Add a new accelerator for the widget. The signal Accel_Signal will be sent to Widget when the matching key is pressed and the widget has the focus. Consider using Gtk.Accel_Map.Add_Entry instead, which is compatible with interactive change of accelerators by the user.

### Remove_Accelerator

- Goto spec in source

    procedure Remove_Accelerator (Widget: access Gtk_Widget_Record;Accel_Group: Gtk.Accel_Group.Gtk_Accel_Group;Accel_Key: Gdk.Types.Gdk_Key_Type;Accel_Mods: Gdk.Types.Gdk_Modifier_Type);

Remove an accelerator for the widget.

### Can_Activate_Accel

- Goto spec in source

    function Can_Activate_Accel (Widget: access Gtk_Widget_Record;Signal_Id: Gulong) return Boolean;

Determines whether an accelerator that activates the signal identified by Signal_Id can currently be activated. This is done by emitting the GtkWidget::can-activate-accel signal on Widget; if the signal isn't overridden by handler or in a derived widget, then the default check is that the widget must be sensitive, and the widget and all its ancestors mapped. Signal_Id comes from the value returned by Gtk.Handlers.Connect

### Set_Accel_Path

- Goto spec in source

    procedure Set_Accel_Path (Widget: access Gtk_Widget_Record;Accel_Path: UTF8_String;Group: Gtk.Accel_Group.Gtk_Accel_Group);

Set the path that will be used to reference the widget in calls to the subprograms in Gtk.Accel_Map. This means, for instance, that the widget is fully setup for interactive modification of the shortcuts by the user, should he choose to activate this possibility in his themes (see gtk-accel_map.ads for more information).

### List_Mnemonic_Labels

- Goto spec in source

    function List_Mnemonic_Labels (Widget: access Gtk_Widget_Record) return Widget_List.Glist;

Returns a newly allocated list of the widgets, normally labels, for which this widget is a the target of a mnemonic (see for example, gtk.label.set_mnemonic_widget). The widgets in the list are not individually referenced. If you want to iterate through the list and perform actions involving callbacks that might destroy the widgets, you must call Ref first, and then unref all the widgets afterwards. The caller must free the returned list.

### Add_Mnemonic_Label

- Goto spec in source

    procedure Add_Mnemonic_Label (Widget: access Gtk_Widget_Record;Label: access Gtk_Widget_Record'Class);

Adds a widget to the list of mnemonic labels for this widget. (See List_Mnemonic_Labels). Note the list of mnemonic labels for the widget is cleared when the widget is destroyed, so the caller must make sure to update its internal state at this point as well, by using a connection to the ::destroy signal or a weak notifier.

### Remove_Mnemonic_Label

- Goto spec in source

    procedure Remove_Mnemonic_Label (Widget: access Gtk_Widget_Record;Label: access Gtk_Widget_Record'Class);

Removes a widget from the list of mnemonic labels for this widget. The widget must have previously been added to the list with Add_Mnemonic_Label.

### Mnemonic_Activate

- Goto spec in source

    function Mnemonic_Activate (Widget: access Gtk_Widget_Record;Group_Cycling: Boolean) return Boolean;

Emits the signal "mnemonic_activate". In general (depending on what is connected to this signal), this results in calling the "activate" signal on the widget, as if a mnemonic had been used (when Group_Cycling if False), or to grab the focus on the widget when Group_Cycling is True)

### Event

- Goto spec in source

    function Event (Widget: access Gtk_Widget_Record'Class;Event: Gdk.Event.Gdk_Event) return Boolean;

Emit a signal on the widget. The exact signal depends on the event type (i.e. if the type is Gdk_Button_Press, then a "button_press" signal is emitted).

### Send_Expose

- Goto spec in source

    procedure Send_Expose (Widget: access Gtk_Widget_Record;Event: Gdk.Event.Gdk_Event_Expose);

Emit an expose event signals on a widget. This function is not normally used directly. The only time it is used is when propagating an expose event to a child No_Window widget, and that is normally done using Gtk.Container.Propagate_Expose. If you want to force an area of a window to be redrawn, use Gdk.Window.Invalidate_Rect or Gdk.Window.Invalidate_Region. To cause the redraw to be done immediately, follow that call with a call to Gdk.Window.Process_Updates.

### Activate

- Goto spec in source

    procedure Activate (Widget: access Gtk_Widget_Record);

Emit an activate signal on the widget. The exact signal emitted depends on the widget type (i.e. for a Gtk_Button this emits a "clicked" signal, for a Gtk_Editable this emits the "activate" signal, ...).

### Grab_Focus

- Goto spec in source

    procedure Grab_Focus (Widget: access Gtk_Widget_Record);

Emit the "grab_focus" signal for the widget. This is sent when the widget gets the focus. Its visual aspect might change. The "Can_Focus" flag must have been set first. See also Gtk.Widget.Child_Focus, which should be used instead when writting new widgets in Ada

### Is_Focus

- Goto spec in source

    function Is_Focus (Widget: access Gtk_Widget_Record) return Boolean;

Determines if the widget is the focus widget within its toplevel. (This does not mean that the HAS_FOCUS flag is necessarily set; HAS_FOCUS will only be set if the toplevel widget additionally has the global input focus)

### Child_Focus

- Goto spec in source

    function Child_Focus (Child: access Gtk_Widget_Record'Class;Direction: Gtk.Enums.Gtk_Direction_Type := Gtk.Enums.Dir_Tab_Forward) return Boolean;

Used by custom widget implementations to indicate the focus child. If you're writing an app, you'd use Grab_Focus to move the focus to a particular widget, and Gtk.Container.Set_Focus_Chain to change the focus tab order. So you may want to investigate those functions instead. Child_Focus is called by containers as the user moves around the window using keyboard shortcuts. Direction indicates what kind of motion is taking place (up, down, left, right, tab forward, tab backward). Child_Focus invokes the "focus" signal on Child; widgets override the default handler for this signal in order to implement appropriate focus behavior. The "focus" default handler for a widget should return True if moving in Direction left the focus on a focusable location inside that widget, and False if moving in Direction moved the focus outside the widget. If returning True, widgets normally call Grab_Focus to place the focus accordingly; if returning False, they don't modify the current focus location. This function replaces Gtk.Container.Focus from GTK+ 1.2. It was necessary to check that the child was visible, sensitive, and focusable before calling Gtk.Container.Focus. Child_Focus returns False if the widget is not currently in a focusable state, so there's no need for those checks. Return value: True if focus ended up inside Child

### Set_Events

- Goto spec in source

    procedure Set_Events (Widget: access Gtk_Widget_Record;Events: Gdk.Event.Gdk_Event_Mask);

### Get_Events

- Goto spec in source

    function Get_Events (Widget: access Gtk_Widget_Record) return Gdk.Event.Gdk_Event_Mask;

Sets or gets the event mask for the widget. Widget should not have been realized before, or nothing is done. This is the only way you can explicitly get mouse or keyboards events on widgets that do not automatically get them, as for instance in a Gtk_Drawing_Area.

### Add_Events

- Goto spec in source

    procedure Add_Events (Widget: access Gtk_Widget_Record;Events: Gdk.Event.Gdk_Event_Mask);

Add some events to the current event mask of the widget.

### Set_Extension_Events

- Goto spec in source

    procedure Set_Extension_Events (Widget: access Gtk_Widget_Record;Mode: Gdk.Types.Gdk_Extension_Mode);

### Get_Extension_Events

- Goto spec in source

    function Get_Extension_Events (Widget: access Gtk_Widget_Record) return Gdk.Types.Gdk_Extension_Mode;

Set the extension event mask for the widget. This is used to activate some special input modes for other devices than keyboard and mouse.

### Default_Motion_Notify_Event

- Goto spec in source

    function Default_Motion_Notify_Event (Widget: access Gtk_Widget_Record'Class;Event: Gdk.Event.Gdk_Event) return Gint;

Access to the standard default callback for motion events: This is mainly used for rulers in Gtk.Ruler (See the example in testgtk, with create_rulers.adb)

### Has_Default_Motion_Notify_Handler

- Goto spec in source

    function Has_Default_Motion_Notify_Handler (Widget: access Gtk_Widget_Record'Class) return Boolean;

Return True if Widget has a default handler for motion_notify events. Note that the function Default_Motion_Notify_Event should not be called if this one returns False, since it would create a segmentation fault.

### Error_Bell

- Goto spec in source

    procedure Error_Bell (Widget: access Gtk_Widget_Record);

Notifies the user about an input-related error on this widget. If the GtkSettings:gtk-error-bell setting is True, it calls Gdk_Window_Beep, otherwise it does nothing. Note that the effect of Gdk_Window_Beep can be configured in many ways, depending on the windowing backend and the desktop environment or window manager that is used.

### Keynav_Failed

- Goto spec in source

    function Keynav_Failed (Widget: access Gtk_Widget_Record;Direction: Gtk.Enums.Gtk_Direction_Type) return Boolean;

This function should be called whenever keyboard navigation within a single widget hits a boundary. The function emits the GtkWidget::keynav-failed signal on the widget and its return value should be interpreted in a way similar to the return value of Child_Focus. When True is returned, stay in the widget, the failed keyboard navigation is Ok and/or there is nowhere we can/should move the focus to. When False is returned, the caller should continue with keyboard navigation outside the widget, e.g. by calling Child_Focus on the widget's toplevel. The default ::keynav-failed handler returns True for Dir_Tab_Forward and Dir_Tab_Backward. For the other values of Gtk_Direction_Type, it looks at the GtkSettings:gtk-keynav-cursor-only setting and returns False if the setting is True. This way the entire user interface becomes cursor-navigatable on input devices such as mobile phones which only have cursor keys but no tab key. Whenever the default handler returns True, it also calls Error_Bell to notify the user of the failed keyboard navigation. A use case for providing an own implementation of ::keynav-failed (either by connecting to it or by overriding it) would be a row of Gtk_Entry widgets where the user should be able to navigate the entire row with the cursor keys, as e.g. known from user interfaces that require entering license keys.

### Set_Colormap

- Goto spec in source

    procedure Set_Colormap (Widget: access Gtk_Widget_Record;Cmap: Gdk.Color.Gdk_Colormap);

### Get_Colormap

- Goto spec in source

    function Get_Colormap (Widget: access Gtk_Widget_Record) return Gdk.Color.Gdk_Colormap;

Modify the colormap of the widget. The widget must not have been realized when you set the colormap. The colormap is generally the same one for all widget, but might be different if for instance Gtk_Drawing_Area needs to display some different colors on a screen that only has a limited amount of colors.

### Get_Visual

- Goto spec in source

    function Get_Visual (Widget: access Gtk_Widget_Record) return Gdk.Visual.Gdk_Visual;

Get the visual used for the widget. I.e. the structure that indicates the depth of the widget (number of bits per pixel), and some information used internally by GtkAda to handle colors and colormaps.

### Push_Colormap

- Goto spec in source
- Goto body in source

    procedure Push_Colormap (Cmap: Gdk.Color.Gdk_Colormap);

### Pop_Colormap

- Goto spec in source
- Goto body in source

    procedure Pop_Colormap;

Modify temporarily the default colormap set for newly created widgets. You should use this in pair with Pop_Colormap (Push the new value, create the widget, and pop the value).

### Set_Default_Colormap

- Goto spec in source
- Goto body in source

    procedure Set_Default_Colormap (Cmap: Gdk.Color.Gdk_Colormap);

### Get_Default_Colormap

- Goto spec in source
- Goto body in source

    function Get_Default_Colormap return Gdk.Color.Gdk_Colormap;

Modify permanently the default colormap used when a widget is created. If you only want to modify this colormap temporarily for a few widgets, you should consider using Push_Colormap and Pop_Colormap instead. See also Gdk.Screen.Get_Default_Colormap for a multihead-aware version

### Get_Default_Visual

- Goto spec in source
- Goto body in source

    function Get_Default_Visual return Gdk.Visual.Gdk_Visual;

Return the default visual used when a new widget is created.

### Is_Composited

- Goto spec in source

    function Is_Composited (Widget: access Gtk_Widget_Record) return Boolean;

Returns whether Widget can rely on having its alpha channel drawn correctly. On X11 this function returns whether a compositing manager is running for Widget's screen. Please note that the semantics of this call will change in the future if used on a widget that has a composited window in its hierarchy (as set by Gdk.Window.Set_Composited).

### Set_Style

- Goto spec in source

    procedure Set_Style (Widget: access Gtk_Widget_Record;Style: Gtk.Style.Gtk_Style);

### Get_Style

- Goto spec in source

    function Get_Style (Widget: access Gtk_Widget_Record) return Gtk.Style.Gtk_Style;

Set or get the style for a given widget. See also Gtk.Rc.Modify_Style

### Get_Default_Style

- Goto spec in source

    function Get_Default_Style return Gtk.Style.Gtk_Style;

Get the default global style.

### Ensure_Style

- Goto spec in source

    procedure Ensure_Style (Widget: access Gtk_Widget_Record);

Make sure that the widget has a style associated to it. Either the default one as set by Set_Default_Style above or one set by the user with Set_Style.

### Restore_Default_Style

- Goto spec in source

    procedure Restore_Default_Style (Widget: access Gtk_Widget_Record);

Restore the default style that was set for the widget. The default style is the first one that was set either by a call to Set_Style or Set_Default_Style.

### Reset_Rc_Styles

- Goto spec in source

    procedure Reset_Rc_Styles (Widget: access Gtk_Widget_Record);

Restore the Rc style recursively for widget and its children.

### Get_Pango_Context

- Goto spec in source

    function Get_Pango_Context (Widget: access Gtk_Widget_Record) return Pango.Context.Pango_Context;

Get a Pango_Context with the appropriate colormap, font description and base direction for this widget. Unlike the context returned by Create_Pango_Context, this context is owned by the widget (it can be used as long as widget exists), and will be updated to match any changes to the widget's attributes. If you create and keep a Pango_Layout using this context, you must deal with changes to the context by calling Pango_Layout.Context_Changed on the layout in response to the ::style_set and ::direction_set signals for the widget.

### Modify_Fg

- Goto spec in source

    procedure Modify_Fg (Widget: access Gtk_Widget_Record;State_Type: Enums.Gtk_State_Type;Color: Gdk.Color.Gdk_Color);

Sets the foreground color for a widget in a particular state. All other style values are left untouched.

### Modify_Bg

- Goto spec in source

    procedure Modify_Bg (Widget: access Gtk_Widget_Record;State_Type: Enums.Gtk_State_Type;Color: Gdk.Color.Gdk_Color);

Sets the background color for a widget in a particular state. All other style values are left untouched. This procedure has no effect when Widget has no physical window associated to it (for instance a Gtk_Label). In such cases, you must put widget inside a Gtk_Event_Box, and set the background color of the box itself.

### Modify_Text

- Goto spec in source

    procedure Modify_Text (Widget: access Gtk_Widget_Record;State_Type: Enums.Gtk_State_Type;Color: Gdk.Color.Gdk_Color);

Sets the text color for a widget in a particular state. All other style values are left untouched. The text color is the foreground color used along with the base color (see Modify_Base) for widgets such as Gtk_Entry and Gtk_Text_View. Note that this will not work with a Gtk_Button. Modify_Fg should be called on the button's label in order to set the color of its label. For example, assuming a simple button with a label attached to it: Modify_Fg (Get_Child (My_Button), My_State, My_New_Color);

### Modify_Base

- Goto spec in source

    procedure Modify_Base (Widget: access Gtk_Widget_Record;State_Type: Enums.Gtk_State_Type;Color: Gdk.Color.Gdk_Color);

Sets the base color for a widget in a particular state. All other style values are left untouched. The base color is the background color used along with the text color (see Modify_Text) for widgets such as Gtk_Entry and Gtk_Text_View.

### Modify_Font

- Goto spec in source

    procedure Modify_Font (Widget: access Gtk_Widget_Record;Desc: Pango.Font.Pango_Font_Description);

Modify the font used for the widget. Desc must be freed by the caller to avoid memory leaks

### Set_Default_Direction

- Goto spec in source
- Goto body in source

    procedure Set_Default_Direction (Dir: Gtk.Enums.Gtk_Text_Direction);

### Get_Default_Direction

- Goto spec in source
- Goto body in source

    function Get_Default_Direction return Gtk.Enums.Gtk_Text_Direction;

Obtains the current default reading direction. See Set_Default_Direction().

### Set_Direction

- Goto spec in source

    procedure Set_Direction (Widget: access Gtk_Widget_Record;Dir: Gtk.Enums.Gtk_Text_Direction);

### Get_Direction

- Goto spec in source

    function Get_Direction (Widget: access Gtk_Widget_Record) return Gtk.Enums.Gtk_Text_Direction;

Sets the reading direction on a particular widget. This direction controls the primary direction for widgets containing text, and also the direction in which the children of a container are packed. The ability to set the direction is present in order so that correct localization into languages with right-to-left reading directions can be done. Generally, applications will let the default reading direction present, except for containers where the containers are arranged in an order that is explicitely visual rather than logical (such as buttons for text justification). If the direction is set to TEXT_DIR_NONE, then the value set by Set_Default_Direction will be used.

### Modify_Cursor

- Goto spec in source

    procedure Modify_Cursor (Widget: access Gtk_Widget_Record;Primary: Gdk.Color.Gdk_Color;Secondary: Gdk.Color.Gdk_Color);

Sets the cursor color to use in a widget, overriding the GtkWidget:cursor-color and GtkWidget:secondary-cursor-color style properties. All other style values are left untouched. See also Gtk.Rc.Modify_Style.

### Set_Name

- Goto spec in source

    procedure Set_Name (Widget: access Gtk_Widget_Record;Name: UTF8_String);

Set the name for the widget. This name is used purely internally to identify the widget, and does not give any visual clue.

### Get_Name

- Goto spec in source

    function Get_Name (Widget: access Gtk_Widget_Record) return UTF8_String;

Return the name of the widget if it was set by Set_Name. Return the name of its class otherwise.

### Path

- Goto spec in source

    function Path          (Widget: access Gtk_Widget_Record) return String;

### Path_Reversed

- Goto spec in source

    function Path_Reversed (Widget: access Gtk_Widget_Record) return String;

Obtains the full path to Widget. The path is simply the name of a widget and all its parents in the container hierarchy, separated by periods. The name of a widget comes from Get_Name. Paths are used to apply styles to a widget in gtkrc configuration files. Widget names are the type of the widget by default (e.g. "GtkButton") or can be set to an application-specific value with Set_Name. By setting the name of a widget, you allow users or theme authors to apply styles to that specific widget in their gtkrc file. Path_Reverse fills in the path in reverse order, starting with widget's name instead of starting with the name of the outermost ancestor.

### Class_Path

- Goto spec in source

    function Class_Path (Widget: access Gtk_Widget_Record) return String;

### Class_Path_Reversed

- Goto spec in source

    function Class_Path_Reversed (Widget: access Gtk_Widget_Record) return String;

Same as Path(), but always uses the name of a widget's type, never uses a custom name set with Set_Name.

### Get_Ancestor

- Goto spec in source

    function Get_Ancestor (Widget: access Gtk_Widget_Record;Ancestor_Type: Gtk_Type) return Gtk_Widget;

Return the closest ancestor of Widget which is of type Ancestor_Type. Return null if there is none.

### Set_Parent

- Goto spec in source

    procedure Set_Parent (Widget: access Gtk_Widget_Record;Parent: access Gtk_Widget_Record'Class);

### Get_Parent

- Goto spec in source

    function Get_Parent (Widget: access Gtk_Widget_Record) return Gtk_Widget;

Modify the parent for the widget. This is not the recommended way to do this, you should use Gtk.Container.Add or Gtk.Box.Pack_Start instead.

### Set_Parent_Window

- Goto spec in source

    procedure Set_Parent_Window (Widget: access Gtk_Widget_Record;Window: Gdk.Window.Gdk_Window);

### Get_Parent_Window

- Goto spec in source

    function Get_Parent_Window (Widget: access Gtk_Widget_Record) return Gdk.Window.Gdk_Window;

Set the parent window for the actual Gdk_Window of the widget. This sets up required internal fields, and should be used only when you implement your own container, as opposed to using one of the standard containers.

### Get_Toplevel

- Goto spec in source

    function Get_Toplevel (Widget: access Gtk_Widget_Record) return Gtk_Widget;

This function returns the topmost widget in the container hierarchy Widget is a part of. If Widget has no parent widgets, it will be returned as the topmost widget. Note the difference in behavior vs. Get_Ancestor: Get_Ancestor (Widget, GTK_TYPE_WINDOW) would return null if Widget wasn't inside a toplevel window, and if the window was inside a Gtk_Window-derived widget which was in turn inside the toplevel Gtk_Window. While the second case may seem unlikely, it actually happens when a Gtk_Plug is embedded inside a Gtk_Socket within the same application. To reliably find the toplevel Gtk_Window, use Get_Toplevel and check if the "toplevel" flag is set on the result: Toplevel := Get_Toplevel (Widget); if Top_Level_Is_Set (Toplevel) then [ Perform some action on Toplevel. ] end if;

### Is_Ancestor

- Goto spec in source

    function Is_Ancestor (Widget: access Gtk_Widget_Record;Ancestor: access Gtk_Widget_Record'Class) return Boolean;

Return True if Ancestor is in the ancestor tree for Widget. I.e. if Widget is contained within Ancestor.

### Reparent

- Goto spec in source

    procedure Reparent (Widget: access Gtk_Widget_Record;New_Parent: access Gtk_Widget_Record'Class);

Change the parent of the widget dynamically. If both the new parent and the widget are shown, then the widget is visually redrawn in its new parent.

### Translate_Coordinates

- Goto spec in source

    procedure Translate_Coordinates (Src_Widget: Gtk_Widget;Dest_Widget: Gtk_Widget;Src_X: Gint;Src_Y: Gint;Dest_X: out Gint;Dest_Y: out Gint;Result: out Boolean);

Translate coordinates relative to Src_Widget's allocation to coordinates relative to Dest_Widget's allocations. In order to perform this operation, both widgets must be realized, and must share a common toplevel. Result is set to False if either widget was not realized, or there was no common ancestor. In this case, nothing is stored in Dest_X and Dest_Y. Otherwise True.

### Get_Root_Window

- Goto spec in source

    function Get_Root_Window (Widget: access Gtk_Widget_Record) return Gdk.Window.Gdk_Window;

Get the root window where this widget is located. This function can only be called after the widget has been added to a widget hierarchy. The root window is useful for such purposes as creating a popup Gdk_Window associated with the window. In general, you should only create display specific resources when a widget has been realized, and you should free those resources when the widget is unrealized.

### Set_Composite_Name

- Goto spec in source

    procedure Set_Composite_Name (Widget: access Gtk_Widget_Record;Name: String);

### Get_Composite_Name

- Goto spec in source

    function Get_Composite_Name (Widget: access Gtk_Widget_Record) return String;

Sets or gets a widgets composite name. The widget must be a composite child of its parent; see Push_Composite_Child.

### Push_Composite_Child

- Goto spec in source
- Goto body in source

    procedure Push_Composite_Child;

### Pop_Composite_Child

- Goto spec in source
- Goto body in source

    procedure Pop_Composite_Child;

Makes all newly-created widgets as composite children until the corresponding Pop_Composite_Child call. A composite child is a child that's an implementation detail of the container it's inside and should not be visible to people using the container. Composite children aren't treated differently by GTK (but see gtk.container.foreach() vs. gtk.container.forall()), but e.g. GUI builders might want to treat them in a different way. Here is a simple example: Push_Composite_Child; Gtk_New (Scrolled_Window.Hscrollbar, Hadjustment); Set_Composite_Name (Scrolled_Window.Hscrollbar, "hscrollbar"); Pop_Composite_Child; Set_Parent (Scrolled_Window.Hscrollbar, Scrolled_Window); Ref (Scrolled_Window.Hscrollbar);

### Set_Scroll_Adjustments

- Goto spec in source

    procedure Set_Scroll_Adjustments (Widget: access Gtk_Widget_Record;Hadj: Gtk.Adjustment.Gtk_Adjustment;Vadj: Gtk.Adjustment.Gtk_Adjustment);

Emit the "set_scroll_adjustments" signal. The exact signal emitted depends on the widget type (see Glib.Object.Initialize_Class_Record). The handler creates the adjustments if null is passed as argument, and makes sure both adjustments are in the correct range.

### Intersect

- Goto spec in source

    function Intersect (Widget: access Gtk_Widget_Record;Area: Gdk.Rectangle.Gdk_Rectangle;Intersection: access Gdk.Rectangle.Gdk_Rectangle) return Boolean;

Return True if the widget intersects the screen area Area. The intersection area is returned in Intersection.

### Region_Intersect

- Goto spec in source

    function Region_Intersect (Widget: access Gtk_Widget_Record;Region: Gdk.Region.Gdk_Region) return Gdk.Region.Gdk_Region;

Region must be in the same coordinate system as the widget's allocation, ie relative to the widget's window, or to the parent's window for No_Window widgets. Returns a newly allocated region. The coordinats are in the same system as described above. Computes the intersection of a Widget's area and Region, returning the intersection. The result may be empty, use gdk.region.empty to check.

### Grab_Default

- Goto spec in source

    procedure Grab_Default (Widget: access Gtk_Widget_Record);

The widget becomes the default widget for its parent window or dialog. All keyboard events will be sent to it if no other widget has the focus. Note that the "Can_Default" flag must have been set first on WIDGET.

### Set_State

- Goto spec in source

    procedure Set_State (Widget: access Gtk_Widget_Record;State: Enums.Gtk_State_Type);

### Get_State

- Goto spec in source

    function Get_State (Widget: access Gtk_Widget_Record) return Enums.Gtk_State_Type;

Modify the state of the widget. This modifies its visual aspect, and thus should be used only if you change its behavior at the same time, so as not to confuse the user.

### Set_Sensitive

- Goto spec in source

    procedure Set_Sensitive (Widget: access Gtk_Widget_Record;Sensitive: Boolean := True);

Modify the sensitivity of the widget. An insensitive widget is generally grayed out, and can not be activated. For instance, an insensitive menu item is grayed, and can never be selected.

### Set_App_Paintable

- Goto spec in source

    procedure Set_App_Paintable (Widget: access Gtk_Widget_Record;App_Paintable: Boolean);

Modify the "App_Paintable" flag for the widget.

### Set_Double_Buffered

- Goto spec in source

    procedure Set_Double_Buffered (Widget: access Gtk_Widget_Record;Double_Buffered: Boolean := True);

Modify the "Double_Buffered" flag for the widget.

### Get_Pointer

- Goto spec in source

    procedure Get_Pointer (Widget: access Gtk_Widget_Record;X: out Gint;Y: out Gint);

Return the coordinates of the pointer (i.e. mouse) relative to Widget.

### Set_Window

- Goto spec in source

    procedure Set_Window (Widget: access Gtk_Widget_Record;Window: Gdk.Window.Gdk_Window);

### Get_Window

- Goto spec in source

    function Get_Window (Widget: access Gtk_Widget_Record) return Gdk.Window.Gdk_Window;

Set the Gdk window associated with the widget. You can use this window if you need to draw directly on the widget using the functions found in the Gdk hierarchy. These functions are rarely used except when you implement your own own widget types. Predefined widgets takes care of that automatically.

### Shape_Combine_Mask

- Goto spec in source

    procedure Shape_Combine_Mask (Widget: access Gtk_Widget_Record;Shape_Mask: Gdk.Bitmap.Gdk_Bitmap;Offset_X: Gint;Offset_Y: Gint);

Modify the shape of the window that contains the widget. This allows for transparent windows, and requires the Xext library to be available on your system. If this library is not available, your program will still work. See the manual page for XShapeCombineMask(3x) for more information.

### Input_Shape_Combine_Mask

- Goto spec in source

    procedure Input_Shape_Combine_Mask (Widget: access Gtk_Widget_Record;Shape_Mask: Gdk.Bitmap.Gdk_Bitmap;Offset_X: Gint;Offset_Y: Gint);

Sets an input shape for this widget's GDK window. This allows for windows which react to mouse click in a nonrectangular region, see Gdk.Window.Input_Shape_Combine_Mask for more information.

### Reset_Shapes

- Goto spec in source

    procedure Reset_Shapes (Widget: access Gtk_Widget_Record);

Recursively resets the shape on this widget and its descendants.

### Render_Icon

- Goto spec in source

    function Render_Icon (Widget: access Gtk_Widget_Record;Stock_Id: String;Size: Gtk.Enums.Gtk_Icon_Size;Detail: UTF8_String := "") return Gdk.Pixbuf.Gdk_Pixbuf;

A convenience function that uses the theme engine for Widget, to lookup a Stock_Id (see Gtk.Stock) and render it to a pixbuf (see Gdk.Pixbuf). Detail should be a string that identifies the widget or code doing the rendering, so that the theme engine can special-case rendering for that widget or code. It can be left to the empty stirng to get the default behavior. Null is returned if Stock_Id wasn't known.

### Get_Snapshot

- Goto spec in source

    function Get_Snapshot (Widget: access Gtk_Widget_Record;Clip_Rect: Gdk.Rectangle.Gdk_Rectangle_Access) return Gdk.Pixmap.Gdk_Pixmap;

Create a Gdk_Pixmap of the contents of the widget and its children. Works even if the widget is obscured. The depth and visual of the resulting pixmap is dependent on the widget being snapshot and likely differs from those of a target widget displaying the pixmap. The function Gdk.Pixbuf.Get_From_Drawable can be used to convert the pixmap to a visual independant representation. The snapshot area used by this function is the Widget's allocation plus any extra space occupied by additional windows belonging to this widget (such as the arrows of a spin button). Thus, the resulting snapshot pixmap is possibly larger than the allocation. If Clip_Rect is non-null, the resulting pixmap is shrunken to match the specified clip_rect. The (x,y) coordinates of Clip_Rect are interpreted widget relative. If width or height of Clip_Rect are 0 or negative, the width or height of the resulting pixmap will be shrunken by the respective amount. For instance using a Clip_Rect'(+5, +5, -10, -10) will chop off 5 pixels at each side of the snapshot pixmap. If non-null, Clip_Rect will contain the exact widget-relative snapshot coordinates upon return. A Clip_Rect of (-1, -1, 0, 0) can be used to preserve the auto-grown snapshot area and use Clip_Rect as a pure output parameter. The returned pixmap can be null, if the resulting Clip_Area was empty.

### Get_Tooltip_Text

- Goto spec in source

    function Get_Tooltip_Text (Widget: access Gtk_Widget_Record) return UTF8_String;

### Set_Tooltip_Text

- Goto spec in source

    procedure Set_Tooltip_Text (Widget: access Gtk_Widget_Record;Text: UTF8_String);

Gets/Sets text as the contents of the tooltip. This function will take care of setting GtkWidget::has-tooltip to TRUE and of the default handler for the GtkWidget::query-tooltip signal. See also the GtkWidget:tooltip-text property and Gtk_Tooltips.Set_Text.

### Get_Tooltip_Markup

- Goto spec in source

    function Get_Tooltip_Markup (Widget: access Gtk_Widget_Record) return UTF8_String;

### Set_Tooltip_Markup

- Goto spec in source

    procedure Set_Tooltip_Markup (Widget: access Gtk_Widget_Record;Text: UTF8_String);

Gets/Sets tooltip contents, marked up with the Pango text markup language. This function will take care of setting GtkWidget:has-tooltip to TRUE and of the default handler for the GtkWidget::query-tooltip signal. See also the GtkWidget::tooltip-markup property and Gtk_Tooltips.Set_Markup.

### Set_Tooltip_Window

- Goto spec in source

    procedure Set_Tooltip_Window (Widget: access Gtk_Widget_Record;Custom_Window: access Gtk_Widget_Record'Class);

Custom_Window : access Gtk.Window.Gtk_Window_Record'Class); Replaces the default, usually yellow, window used for displaying tooltips with custom_window. GTK+ will take care of showing and hiding Custom_Window at the right moment, to behave likewise as the default tooltip window. If Custom_Window is NULL, the default tooltip window will be used.

### Get_Tooltip_Window

- Goto spec in source

    function Get_Tooltip_Window (Widget: access Gtk_Widget_Record) return Gtk_Widget;

return Gtk.Window.Gtk_Window; Returns the GtkWindow of the current tooltip. This can be the GtkWindow created by default, or the custom tooltip window set using Gtk.Widget.Set_Tooltip_Window.

### Get_Has_Tooltip

- Goto spec in source

    function Get_Has_Tooltip (Widget: access Gtk_Widget_Record) return Boolean;

### Set_Has_Tooltip

- Goto spec in source

    procedure Set_Has_Tooltip (Widget: access Gtk_Widget_Record;Has_Tooltip: Boolean);

Gets/Sets the has-tooltip property on Widget to Has_Tooltip. See GtkWidget:has-tooltip for more information.

### Trigger_Tooltip_Query

- Goto spec in source

    procedure Trigger_Tooltip_Query (Widget: access Gtk_Widget_Record);

Triggers a tooltip query on the display where the toplevel of Widget is located. See Gtk.Tooltip.Trigger_Tooltip_Query for more information.

### Set_Scroll_Adjustments_Signal

- Goto spec in source

    procedure Set_Scroll_Adjustments_Signal (Widget: Glib.Object.GObject_Class;Signal: String);

Modify the signal to be sent when the adjustments are modified. This is only useful when you are rewritting your own widget that can be embedded directly in a Gtk_Scrolled_Window, without any Gtk_Viewport. Signal is the name of the signal that will be emitted when Widget is put inside a Gtk_Scrolled_Window. Note that the handlers for this signal must take two arguments in addition to the widget (the horizontal and vertical adjustments to be used). See Gtk.Scrolled_Window and Gtk.Widget.Set_Scroll_Adjustment for more information on this signal.

### Set_Default_Size_Allocate_Handler

- Goto spec in source
- Goto body in source

    procedure Set_Default_Size_Allocate_Handler (Klass: Glib.Object.GObject_Class;Handler: Size_Allocate_Handler);

Override the default size_allocate handler for this class. This handler is automatically called in several cases (when a widget is dynamically resized for instance), not through a signal. Thus, if you need to override the default behavior provided by one of the standard containers, you can not simply use Gtk.Handlers.Emit_Stop_By_Name, and you must override the default handler. Note also that this handler is automatically inherited by children of this class.

### Set_Allocation

- Goto spec in source

    procedure Set_Allocation (Widget: access Gtk_Widget_Record'Class;Alloc: Gtk_Allocation);

Modifies directly the internal field of Widget to register the new allocation. Beware that the only use of this method is inside a callback set by Set_Default_Size_Allocate_Handler. If you simply want to resize or reposition a widget, use Size_Allocate instead.

### Default_Expose_Event_Handler

- Goto spec in source
- Goto body in source

    function Default_Expose_Event_Handler (Klass: GObject_Class) return Expose_Event_Handler;

Return the default expose event handler for the widget class Klass. The typical use for this function is when you are writting your own container class. You should then, from your own handler for expose_event, call the one of the parent class, so that all the children are automatically redrawn.

### Flags

- Goto spec in source

    function Flags (Widget: access Gtk_Widget_Record) return Guint32;

Return the flags that are set for the object, as a binary mask.

### Set_Flags

- Goto spec in source

    procedure Set_Flags (Widget: access Gtk_Widget_Record;Flags: Guint32);

Set some specific flags for the object. Flags is a mask that will be added to the current flags of the object.

### Unset_Flags

- Goto spec in source

    procedure Unset_Flags (Widget: access Gtk_Widget_Record;Flags: Guint32);

Unset some specific flags for the object. Flags is a mask that will be deleted from the current flags of the object.

### Flag_Is_Set

- Goto spec in source

    function Flag_Is_Set (Widget: access Gtk_Widget_Record;Flag: Guint32) return Boolean;

Return True if the specific flag Flag is set for the object.

### In_Destruction_Is_Set

- Goto spec in source

    function In_Destruction_Is_Set (Widget: access Gtk_Widget_Record'Class) return Boolean;

Test if the Destroyed flag is set for the object.

### Destroyed_Is_Set

- Goto spec in source

    function Destroyed_Is_Set (Widget: access Gtk_Widget_Record'Class) return Boolean renames In_Destruction_Is_Set;

<doc_ignore>

### Floating_Is_Set

- Goto spec in source

    function Floating_Is_Set (Widget: access Gtk_Widget_Record'Class) return Boolean;

Test if the Floating flag is set for the object.

### Toplevel_Is_Set

- Goto spec in source

    function Toplevel_Is_Set (Widget: access Gtk_Widget_Record'Class) return Boolean;

Test whether the Toplevel flag is set.

### No_Window_Is_Set

- Goto spec in source

    function No_Window_Is_Set (Widget: access Gtk_Widget_Record'Class) return Boolean;

Test whether the No_Window flag is set.

### Realized_Is_Set

- Goto spec in source

    function Realized_Is_Set (Widget: access Gtk_Widget_Record'Class) return Boolean;

Test whether the Realized flag is set.

### Mapped_Is_Set

- Goto spec in source

    function Mapped_Is_Set (Widget: access Gtk_Widget_Record'Class) return Boolean;

Test whether the Mapped flag is set.

### Visible_Is_Set

- Goto spec in source

    function Visible_Is_Set (Widget: access Gtk_Widget_Record'Class) return Boolean;

Test whether the Visible flag is set.

### Drawable_Is_Set

- Goto spec in source

    function Drawable_Is_Set (Widget: access Gtk_Widget_Record'Class) return Boolean;

True if the widget is both visible and mapped. In other words, if it does appear on the screen.

### Is_Sensitive

- Goto spec in source

    function Is_Sensitive (Widget: access Gtk_Widget_Record'Class) return Boolean;

Test whether the widget is Sensitive.

### Can_Focus_Is_Set

- Goto spec in source

    function Can_Focus_Is_Set (Widget: access Gtk_Widget_Record'Class) return Boolean;

Test whether the Can_Focus flag is set.

### Has_Focus_Is_Set

- Goto spec in source

    function Has_Focus_Is_Set (Widget: access Gtk_Widget_Record'Class) return Boolean;

Test whether the Has_Focus flag is set.

### Has_Default_Is_Set

- Goto spec in source

    function Has_Default_Is_Set (Widget: access Gtk_Widget_Record'Class) return Boolean;

Test whether the Has_Default flag is set.

### Has_Grab_Is_Set

- Goto spec in source

    function Has_Grab_Is_Set (Widget: access Gtk_Widget_Record'Class) return Boolean;

Test whether the Has_Grab flag is set.

### Rc_Style_Is_Set

- Goto spec in source

    function Rc_Style_Is_Set (Widget: access Gtk_Widget_Record'Class) return Boolean;

Test whether the Rc_Style flag is set.

### Double_Buffered_Is_Set

- Goto spec in source

    function Double_Buffered_Is_Set (Widget: access Gtk_Widget_Record'Class) return Boolean;

Test whether the Double_Buffered flag is set.

### Get_Requisition

- Goto spec in source

    function Get_Requisition (Value: Glib.Values.GValue) return Gtk_Requisition_Access;

Convert a value into a Gtk_Requisition_Access.

### Get_Allocation

- Goto spec in source

    function Get_Allocation (Value: Glib.Values.GValue) return Gtk_Allocation_Access;

Convert a value into a Gtk_Allocation_Access.

### Draw

- Goto spec in source

    procedure Draw (Widget: access Gtk_Widget_Record;Area: Gdk.Rectangle.Gdk_Rectangle := Gdk.Rectangle.Full_Area);

Draw Emit a "draw" signal for a specific area of the widget. The visual aspect might be different whether the widget has the focus or not.

### Set_UPosition

- Goto spec in source

    procedure Set_UPosition (Widget: access Gtk_Widget_Record;X, Y: Gint);

Set_Uposition Modify the position of the widget. This should be used only for toplevel widgets (windows and dialogs), since other widgets' positions are handled by their parent.

### Set_USize

- Goto spec in source

    procedure Set_USize (Widget: access Gtk_Widget_Record;Width, Height: Gint);

Set_Usize Modify the size of the widget. This sets an absolute size for the widget, no matter what its requested size would be. For Gtk_Windows, you should consider using Set_Default_Size instead, which sets a minimal size, but use the widget's requested size if it is bigger. If Width or Height is negative, they are ignored, and the widget's default width is kept.

### Queue_Clear

- Goto spec in source

    procedure Queue_Clear (Widget: access Gtk_Widget_Record);

Queue_Clear Add a clear request to the event queue for the whole widget. This is added to the same list as for Queue_Draw, and thus is coalesced as much as possible with other drawing requests.

### Queue_Clear_Area

- Goto spec in source

    procedure Queue_Clear_Area (Widget: access Gtk_Widget_Record;X: Gint;Y: Gint;Width: Gint;Height: Gint);

Queue_Clear_Area Add a clear request to the event queue for part of the widget. This is added to the same list as for Queue_Draw, and thus is coalesced as much as possible with other drawing requests.

### Child_Notify

- Goto spec in source

    procedure Child_Notify (Widget: access Gtk_Widget_Record;Child_Property: String);

Emits a "child-notify" signal for the child property on Widget. This signal indicates the the value of the child property has changed on the parent, and thus that Widget should refresh itself if needed. Child_Property is the name of a child property installed on Widget's parent. You should use Glib.Propert_Name to get the name from the property declaration in each of the GtkAda packages

### Freeze_Child_Notify

- Goto spec in source

    procedure Freeze_Child_Notify (Widget: access Gtk_Widget_Record);

Stops emission of "child-notify" signals on Widget. The signals are queued until Thaw_Child_Notify() is called on Wwidget.

### Thaw_Child_Notify

- Goto spec in source

    procedure Thaw_Child_Notify (Widget: access Gtk_Widget_Record);

Reverts the effect of a previous call to Freeze_Child_Notify. This causes all queued "child-notify" signals on Widget to be emitted.

### Class_Install_Style_Property

- Goto spec in source
- Goto body in source

    procedure Class_Install_Style_Property (Klass: Glib.Object.GObject_Class;Pspec: Glib.Param_Spec);

Installs a style property on a widget class. The parser for the style property is determined by the value type of Pspec. A style property configures the look-and-feel of a widget class. They are generally modified by the current gtk+ theme, although users can also modify them in their own configuration file.

### Class_List_Style_Properties

- Goto spec in source

    function Class_List_Style_Properties (Klass: Glib.Object.GObject_Class) return Glib.Param_Spec_Array;

Returns all style properties of a widget class.

### Class_Find_Style_Property

- Goto spec in source

    function Class_Find_Style_Property (Klass: Glib.Object.GObject_Class;Property_Name: String) return Glib.Param_Spec;

Finds a style property of a widget class by name. Klass must be a descendent of Gtk_Widget. You should use Glib.Property_Name to get the name from the property declaration in each of the GtkAda packages

### Style_Get_Property

- Goto spec in source

    procedure Style_Get_Property (Widget: access Gtk_Widget_Record;Property_Name: String;Value: out Glib.Values.GValue);

Gets the value of a style property of Widget. You should use Glib.Property_Name to get the name from the property declaration in each of the GtkAda packages