class UIControl

Additions to UIControl to support jQuery-style `on` and `off` methods.

Public Instance Methods

off(*events) click to toggle source

Removes all events that were bound with `on`. See symbol.rb for the uicontrolevent constant aliases.

@example

button.off(:touch)
button.off(:touch_up_outside, :touch_cancel)
button.off  # all events
# File lib/ios/sugarcube-events/uicontrol.rb, line 33
def off(*events)
  if events.length == 0
    events = sugarcube_callbacks.keys
  end

  events.each do |event|
    event = event.uicontrolevent if event.respond_to?(:uicontrolevent)

    sugarcube_callbacks(event).each do |handler|
      self.removeTarget(handler, action:'call:event:', forControlEvents:event)
    end
    sugarcube_callbacks.delete(event)
  end

  self
end
on(*events, &block) click to toggle source

Add event handlers to UIControls. See symbol.rb for the uicontrolevent constant aliases.

@example

button = UIButton.alloc.initWithFrame([0, 0, 10, 10])
button.on(:touch) { my_code }
button.on(:touch_up_outside, :touch_cancel) { my_code }
# up to two arguments can be passed in
button.on(:touch) { |sender,touch_event| my_code }
# File lib/ios/sugarcube-events/uicontrol.rb, line 13
def on(*events, &block)
  handler = SugarCube::UIControlCallbackHelper.new(block)

  events.each do |event|
    event = event.uicontrolevent if event.respond_to?(:uicontrolevent)

    sugarcube_callbacks(event).push(handler)
    self.addTarget(handler, action:'call:event:', forControlEvents:event)
  end

  self
end
trigger(*events) click to toggle source

Useful during testing, or to simulate a button press.

@example

button.trigger(:touch)
button.trigger(:touch_drag_outside, :touch_drag_exits)
# File lib/ios/sugarcube-events/uicontrol.rb, line 55
def trigger(*events)
  event_mask = 0
  events.each do |event|
    event = event.uicontrolevent if event.respond_to?(:uicontrolevent)
    event_mask |= event
  end
  sendActionsForControlEvents(event_mask)
end

Private Instance Methods

sugarcube_callbacks(event=nil) click to toggle source

event blocks need to be retained, and the addTarget method explicitly does not retain `target`. This makes sure that callbacks are retained by pushing the block onto a stack.

# File lib/ios/sugarcube-events/uicontrol.rb, line 68
def sugarcube_callbacks(event=nil)
  @sugarcube_callbacks ||= {}
  if event
    @sugarcube_callbacks[event] ||= []
    return @sugarcube_callbacks[event]
  else
    return @sugarcube_callbacks
  end
end