class Iup::Val

An interactive control allowing the user to select a value within a limited range.

Example

The following sets up a vertical control with a range from 0 to 10. As the slider is moved, a label’s title is updated to the current value.

Iup::Val.new('vertical') do |v|
  t.max = 10
  v.valuechanged_cb = ->{
    label.title = "VALUE=#{"%0.2f" % v.value}"
    Iup::DEFAULT
  }
end

Attributes

canfocus [RW]

Enables the control to gain focus. Values ‘yes’ / ‘no’.

expand [RW]

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

inverted [RW]

If set, places maximum value on opposite side: values ‘yes’ / ‘no’.

max [RW]

Maximum value, defaults to 1.

min [RW]

Minimum value, defaults to 0.

orientation [RW]

Orientation of control: ‘horizontal’ / ‘vertical’

pagestep [RW]

Proportion of increment for pageup / pagedown. Value between 0.0 and 1.0, default is 0.1.

position [R]

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

rastersize [RW]

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

screenposition [R]

Returns position in pixels on screen as “x,y”.

step [RW]

Proportion of increment for up / down. Value between 0.0 and 1.0, default is 0.01.

value [RW]

Returns the current value of the control.

Public Class Methods

new (orientation='horizontal') { |self| ... }

Source

# File lib/wrapped/val.rb, line 24
def initialize(orientation='horizontal')
  @handle = IupLib.IupVal(orientation)

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

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

orientation - ‘horizontal’ / ‘vertical’

Callbacks

Attributes

button_press_cb [W]

Calls callback when mouse button pressed to change the control value. Callback must respond to call and take no arguments.

button_release_cb [W]

Calls callback when mouse button released. Callback must respond to call and take no arguments.

mousemove_cb [W]

Calls callback when mouse is used to move control. Callback must respond to call and take no arguments.

valuechanged_cb [W]

Calls callback after the value was interactively changed by the user. Callback must respond to call and take no arguments.