Tk::OptionObj

Public Class Methods

new(hash = nil) click to toggle source

 
               # File tk/lib/tk/optionobj.rb, line 17
def initialize(hash = nil)
  super()
  @observ = []
  update_without_notify(_symbolkey2str(hash)) if hash
end

Public Instance Methods

+(hash) click to toggle source

 
               # File tk/lib/tk/optionobj.rb, line 163
def +(hash)
  unless hash.kind_of?(Hash)
    fail ArgumentError, "expect a Hash"
  end
  new_obj = self.dup
  new_obj.update_without_notify(_symbolkey2str(hash))
  new_obj
end

[](key) click to toggle source

 
               # File tk/lib/tk/optionobj.rb, line 187
def [](key)
  super(key.to_s)
end

Also aliased as: cget

[]=(key, val) click to toggle source

 
               # File tk/lib/tk/optionobj.rb, line 197
def []=(key, val)
  store(key,val)
end

apply(target = nil) click to toggle source

Alias for: notify

assign(*wins) click to toggle source

 
               # File tk/lib/tk/optionobj.rb, line 59
def assign(*wins)
  # win :=
  #   widget             #==> call widget.configure(hash)
  #   [widget]           #==> call widget.configure(hash)
  #   [widget, nil, {src=>target, ... }]
  #                      #==> call widget.configure(hash)
  #                               with converting hash-key
  #   [widget, method]   #==> call widget.method(hash)
  #   [widget, method, {src=>target, ... }]
  #                      #==> call widget.method(hash)
  #                               with converting hash-key
  #   [widget [receiver, method, arg, ... ]]
  #                      #==> call receiver.method(arg, ... , hash)
  #   [widget [receiver, method, arg, ... ], {src=>target, ... }]
  #                      #==> call receiver.method(arg, ... , hash)
  #                               with onverting hash-key
  #
  # src := option_name_on_optobj
  #
  # target :=
  #   nil                #==> not use the src
  #   option_name_on_target_widget
  #   [ option_name_on_target_widget, ... ]
  #                      #==> set all of them
  #
  wins.each{|win|
    _remove_win(win)
    @observ << win
    notify(win)
  }
  self
end

cget(key) click to toggle source

Alias for: []

configure(key, value=nil) click to toggle source

 
               # File tk/lib/tk/optionobj.rb, line 179
def configure(key, value=nil)
  if key.kind_of?(Hash)
    update(key)
  else
    store(key,value)
  end
end

notify(target = nil) click to toggle source

 
               # File tk/lib/tk/optionobj.rb, line 99
def notify(target = nil)
  if target
    targets = [target]
  elsif @observ.empty?
    return self
  else
    targets = @observ.dup
  end

  return self if empty?

  org_hash = _symbolkey2str(self)

  targets.each{|win|
    widget = receiver = win
    hash = org_hash
    begin
      if win.kind_of?(Array)
        widget, method, conv_tbl = win
        receiver = widget

        if conv_tbl
          hash = {}
          org_hash.each{|key, val|
            key = conv_tbl[key] if conv_tbl.key?(key)
            next unless key
            if key.kind_of?(Array)
              key.each{|k| hash[k] = val}
            else
              hash[key] = val
            end
          }
        end

        if method.kind_of?(Array)
          receiver, method, *args = method
          receiver.__send__(method, *(args << hash))
        elsif method
          widget.__send__(method, hash)
        else
          widget.configure(hash)
        end

      else
        widget.configure(self)
      end
    rescue => e
      if ( ( widget.kind_of?(TkObject)                  && widget.respond_to?('exist?')                  && ! receiver.exist? )              || ( receiver.kind_of?(TkObject)                  && receiver.respond_to?('exist?')                  && ! receiver.exist? ) )
        @observ.delete(win)
      else
        fail e
      end
    end
  }

  self
end

Also aliased as: apply

observ_info() click to toggle source

 
               # File tk/lib/tk/optionobj.rb, line 23
def observ_info
  @observ.dup
end

observs() click to toggle source

 
               # File tk/lib/tk/optionobj.rb, line 27
def observs
  @observ.collect{|win|
    if win.kind_of?(Array)
      win[0]
    else
      win
    end
  }
end

replace(hash) click to toggle source

 
               # File tk/lib/tk/optionobj.rb, line 201
def replace(hash)
  super(_symbolkey2str(hash))
  notify
end

store(key, val) click to toggle source

 
               # File tk/lib/tk/optionobj.rb, line 192
def store(key, val)
  key = key.to_s
  super(key, val)
  notify
end

unassign(*wins) click to toggle source

 
               # File tk/lib/tk/optionobj.rb, line 92
def unassign(*wins)
  wins.each{|win|
    _remove_win(win)
  }
  self
end

update(hash) click to toggle source

 
               # File tk/lib/tk/optionobj.rb, line 174
def update(hash)
  update_without_notify(_symbolkey2str(hash))
  notify
end

Also aliased as: update_without_notify

update_without_notify(hash) click to toggle source

Alias for: update

Commenting is here to help enhance the documentation. For example, code samples, or clarification of the documentation.

If you have questions about Ruby or the documentation, please post to one of the Ruby mailing lists. You will get better, faster, help that way.

If you wish to post a correction of the docs, please do so, but also file bug report so that it can be corrected for the next release. Thank you.

If you want to help improve the Ruby documentation, please visit Documenting-ruby.org.