class Iup::Expander

An expandable container for a single widget. The user can show or hide the child widget, as required.

Example

The following places a button in an expandable area, with a blue title:

bt = Iup::Button.new('Button ONE')

exp = Iup::Expander.new(bt) do |e|
  e.title = 'Expander title'
  e.forecolor = '0 0 255'
end

Attributes

autoshow [RW]

If set, child will be shown when mouse hovers over container. Values ‘yes’ / ‘no’.

backcolor [RW]

Color of background in title area, as “r g b”.

barposition [RW]

Position of expander bar, as ‘top’ / ‘bottom’ / ‘left’ / ‘right’.

barsize [RW]

Size of bar - defaults to text line height + 5.

clientoffset [R]

Returns current offset of box in its client as “widthxheight”.

clientsize [R]

Returns current size of box as “widthxheight”.

expand [RW]

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

forecolor [RW]

Color of text in title area, as “r g b”.

position [R]

Returns position in pixels within client window as “x,y”.

rastersize [RW]

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

state [RW]

Show or hide child, as ‘open’ / ‘close’.

title [RW]

Displayed on box in title area.

Public Class Methods

new (child) { |self| ... }

Source

# File lib/wrapped/expander.rb, line 23
def initialize child
  @handle = IupLib.IupExpander(child.handle)

  yield self if block_given?
end

Creates an instance of the Expander. If a block is given, the new instance is yielded to it.

child - the child widget to display.

Callbacks

Attributes

action [W]

Callback called after the expander state is interactively changed. Callback must respond to call and take no arguments.

openclose_cb [W]

Callback called before the expander state is interactively changed. Callback must respond to call and take no arguments, returning new state or Iup::IGNORE.