A Gtk_Paned is a container that organizes its two children either horizontally or vertically. The initial size allocated to the children depends on the size they request. However, the user has the possibility to interactively move a separation bar between the two to enlarge one of the children, while at the same time shrinking the second one. The bar can be moved by clicking with the mouse on a small cursor displayed in the bar, and then dragging the mouse.
No additional decoration is provided around the children.
Each child has two parameters, Resize and Shrink.
If Shrink is True, then the widget can be made smaller than its requisition size by the user. Set this to False if you want to set a minimum size.
if Resize is True, this means that the child accepts to be resized, and will not require any size. Thus, the size allocated to it will be the total size allocated to the container minus the size requested by the other child. If Resize is False, the child should ask for a specific size, which it will get. The other child will be resized accordingly. If both Child have the same value for Resize (either True or False), then the size allocated to each is a ratio between the size requested by both.
When you use Set_Position with a parameter other than -1, or the user moves the handle to resize the widgets, the behavior of Resize is canceled.
Widget Hierarchy |
---|
Gtk_Object (see section Package Gtk.Object) \___ Gtk_Widget (see section Package Gtk.Widget) \___ Gtk_Container (see section Package Gtk.Container) \___ Gtk_Paned (see section Package Gtk.Paned) |
Subprograms |
---|
procedure Gtk_New_Vpaned (Widget : out Gtk_Paned); | ||
Create a new vertical container. | ||
procedure Gtk_New_Hpaned (Widget : out Gtk_Paned); | ||
Create a new horizontal container. | ||
procedure Initialize_Vpaned (Widget : access Gtk_Paned_Record'Class); | ||
Internal initialization function. | ||
procedure Initialize_Hpaned (Widget : access Gtk_Paned_Record'Class); | ||
Internal initialization function. | ||
function Get_Type return Gtk.Gtk_Type; | ||
Return the internal value associated with a Gtk_Paned.
| ||
function Get_Type_Vpaned return Gtk.Gtk_Type; | ||
Return the internal value associated with a vertical Gtk_Paned.
| ||
function Get_Type_Hpaned return Gtk.Gtk_Type; | ||
Return the internal value associated with a horizontal Gtk_Paned.
| ||
procedure Add1 (Paned : access Gtk_Paned_Record; Child : access Gtk_Widget_Record'Class); | ||
Add the first child of the container. | ||
procedure Pack1 (Paned : access Gtk_Paned_Record; Child : access Gtk_Widget_Record'Class; Resize : in Boolean := False; Shrink : in Boolean := True); | ||
Add a child to the top or left pane. | ||
procedure Add2 (Paned : access Gtk_Paned_Record; Child : access Gtk_Widget_Record'Class); | ||
Add the second child of the container. | ||
procedure Pack2 (Paned : access Gtk_Paned_Record; Child : access Gtk_Widget_Record'Class; Resize : in Boolean := False; Shrink : in Boolean := False); | ||
Add a child to the bottom or right pane.
| ||
procedure Set_Position (Paned : access Gtk_Paned_Record; Position : Gint); | ||
Change the position of the separator, as if set by the user. | ||
procedure Set_Handle_Size (Paned : access Gtk_Paned_Record; Size : Guint16); | ||
Set the handle size to Size x Size pixels. | ||
function Get_Handle_Size (Paned : access Gtk_Paned_Record) return Guint16; | ||
Return the current size in pixels of the handle.
| ||
procedure Set_Gutter_Size (Paned : access Gtk_Paned_Record; Size : in Guint16); | ||
Set the width in pixels of the gutter. | ||
function Get_Gutter_Size (Paned : access Gtk_Paned_Record) return Guint16; | ||
Return the width in pixels of the gutter.
| ||
function Get_Child1 (Paned : access Gtk_Paned_Record) return Gtk.Widget.Gtk_Widget; | ||
Return the child displayed in the top or left pane.
| ||
function Get_Child2 (Paned : access Gtk_Paned_Record) return Gtk.Widget.Gtk_Widget; | ||
Return the child displayed in the bottom or right pane.
| ||
function Get_Child1_Resize (Paned : access Gtk_Paned_Record) return Boolean; | ||
Get the value of the resize attribute for the first child.
| ||
function Get_Child2_Resize (Paned : access Gtk_Paned_Record) return Boolean; | ||
Get the value of the resize attribute for the second child.
| ||
function Get_Child1_Shrink (Paned : access Gtk_Paned_Record) return Boolean; | ||
Get the value of the shrink attribute for the first child.
| ||
function Get_Child2_Shrink (Paned : access Gtk_Paned_Record) return Boolean; | ||
Get the value of the shrink attribute for the second child.
|