class Iup::GridBox

A container which arranges its widgets in a left-to-right, top-to-bottom order.

Attributes

alignmentcol

gets/sets horizontal alignment of columns.

alignmentlin

vertical alignment within line, as 'atop' / 'abottom' / 'acenter'

cgapcol

n, horizontal space in characters between columns.

cgaplin

n, vertical space in characters between lines.

clientoffset

read-only, returns current offset of box in its client as “widthxheight”.

clientsize

read-only, returns current size of box as “widthxheight”.

cmargin

Margin in x and y directions in characters, value as “mxn”.

expand

Allows container to fill available space in indicated direction. Values 'no' / 'horizontal' / 'vertical' / 'yes'.

expandchildren

Set to allow children to expand fully, values as 'yes' / 'no' / 'horizontal' / 'vertical'.

fittochildren

'column' / 'line', n -> force column/line n to fit largest element in that column/line.

gapcol

n, horizontal space in pixels between columns.

gaplin

n, vertical space in pixels between lines.

homogeneouscol

Forces all columns to have same horizontal space, values as 'yes' / 'no'.

homogeneouslin

Forces all lines to have same vertical space. values as 'yes' / 'no'.

margin

Margin in x and y directions in pixels, value as “mxn”.

normalsize

Set to make natural size of children same, values as 'yes' / 'no' / 'horizontal' / 'vertical'.

numcol

read-only returns number of columns.

numdiv

'auto' / n, controls number of divisions in direction as determined by orientation.

numlin

read-only returns number of lines.

orientation

Controls distribution of children, in lines or columns. Value as 'horizontal' / 'vertical'.

position

read-only returns position in pixels within client window as “x,y”.

rastersize

Size of the container, in pixels, value as “widthxheight”.

sizecol

Index of column to use for calculating height of lines.

sizelin

Index of line to use for calculating width of columns.

Public Class Methods

new(*widgets, &block) click to toggle source

Creates an instance of the hbox.

*widgets

one or more child widgets

block

optional block to set up the box's attributes.

# File lib/wrapped/gridbox.rb, line 51
def initialize *widgets, &block
  @handle = IupLib.IupGridBox *widget_list(widgets)

  # run any provided block on instance, to set up further attributes
  self.instance_eval &block if block_given?
end