Select.c File Reference

#include <assert.h>
#include <Objectively/Array.h>
#include "Select.h"

Go to the source code of this file.

Macros
#define	_Class   _Select

Functions
Class *	_Select (void)
static void	addOption (Select *self, const char *title, ident value)
static void	addOption_addSubview (const Array *array, ident obj, ident data)
	ArrayEnumerator to add Options to the stackView.
static void	addOption_removeSubview (const Array *array, ident obj, ident data)
	ArrayEnumerator to remove Options from the stackView.
static bool	captureEvent (Control *self, const SDL_Event *event)
static void	dealloc (Object *self)
static View *	init (View *self)
static void	initialize (Class *clazz)
static Select *	initWithFrame (Select *self, const SDL_Rect *frame)
static void	layoutSubviews (View *self)
static Option *	optionWithValue (const Select *self, const ident value)
static bool	optionWithValue_predicate (ident obj, ident data)
	Predicate function for optionWithValue.
static void	removeAllOptions (Select *self)
static void	removeOption (Select *self, Option *option)
static void	removeOptionWithValue (Select *self, ident value)
static Option *	selectedOption (const Select *self)
static Array *	selectedOptions (const Select *self)
static bool	selectedOptions_predicate (ident obj, ident data)
	Predicate for selectedOption and selectedOptions.
static void	selectOption (Select *self, Option *option)
static void	selectOption_enumerate (const Array *array, ident obj, ident data)
	ArrayEnumerator for enforcing ControlSelectionSingle.
static void	selectOptionWithValue (Select *self, ident value)
static SDL_Size	sizeThatFits (const View *self)
static void	stateDidChange (Control *self)

Macro Definition Documentation

_Class

#define _Class   _Select

Definition at line 30 of file Select.c.

Function Documentation

_Select()

Class * _Select

(

void

)

Definition at line 483 of file Select.c.

                     {
  static Class *clazz;
  static Once once;
 
  do_once(&once, {
    clazz = _initialize(&(const ClassDef) {
      .name = "Select",
      .superclass = _Control(),
      .instanceSize = sizeof(Select),
      .interfaceSize = sizeof(SelectInterface),
      .initialize = initialize,
    });
  });
 
  return clazz;
}

addOption()

static void addOption ( Select *  self, const char *  title, ident  value  )

static

Definition at line 274 of file Select.c.

                                                                    {
 
  Option *option = $(alloc(Option), initWithTitle, title, value);
  assert(option);
 
  $(self->options, addObject, option);
 
  $((Array *) self->options, enumerate, addOption_removeSubview, self->stackView);
 
  if (self->comparator) {
    $(self->options, sort, self->comparator);
  }
 
  $((Array *) self->options, enumerate, addOption_addSubview, self->stackView);
 
  if (self->control.selection == ControlSelectionSingle) {
    if ($(self, selectedOption) == NULL) {
      $(option, setSelected, true);
    }
  }
 
  option->view.nextResponder = (View *) self;
 
  release(option);
 
  $((View *) self, setNeedsLayout);
}

addOption_addSubview()

static void addOption_addSubview ( const Array *  array, ident  obj, ident  data  )

static

ArrayEnumerator to add Options to the stackView.

Definition at line 266 of file Select.c.

                                                                            {
  $((View *) data, addSubview, obj);
}

addOption_removeSubview()

static void addOption_removeSubview ( const Array *  array, ident  obj, ident  data  )

static

ArrayEnumerator to remove Options from the stackView.

Definition at line 259 of file Select.c.

                                                                               {
  $((View *) data, removeSubview, obj);
}

captureEvent()

static bool captureEvent ( Control *  self, const SDL_Event *  event  )

static

See also

Control::captureEvent(Control *, const SDL_Event *)

Definition at line 137 of file Select.c.

                                                                {
 
  Select *this = (Select *) self;
 
  const Array *options = (Array *) this->options;
 
  if (event->type == SDL_EVENT_MOUSE_BUTTON_DOWN) {
    if (self->state & ControlStateHighlighted) {
      $((View *) self, becomeTouchResponder);
      return true;
    }
  }
 
  if (event->type == SDL_EVENT_MOUSE_BUTTON_UP) {
    if (self->state & ControlStateHighlighted) {
      self->state &= ~ControlStateHighlighted;
 
      for (size_t i = 0; i < options->count; i++) {
 
        Option *option = $(options, objectAtIndex, i);
        if ($((View *) option, didReceiveEvent, event)) {
          $(this, selectOption, option);
          if (this->delegate.didSelectOption) {
            this->delegate.didSelectOption(this, option);
          }
          return true;
        }
      }
    } else {
      self->state |= ControlStateHighlighted;
      return true;
    }
  }
 
  if (event->type == SDL_EVENT_KEY_DOWN) {
 
    switch (event->key.key) {
 
      case SDLK_ESCAPE:
        self->state &= ~ControlStateHighlighted;
        return true;
 
      case SDLK_RETURN:
      case SDLK_KP_ENTER:
        self->state ^= ControlStateHighlighted;
        return true;
 
      case SDLK_UP:
      case SDLK_DOWN: {
        Option *option = $(this, selectedOption);
        if (option) {
 
          ssize_t index = $(options, indexOfObject, option);
          if (event->key.key == SDLK_UP) {
            index = (index - 1 + options->count) % options->count;
          } else {
            index = (index + 1) % options->count;
          }
 
          option = $(options, objectAtIndex, index);
 
          $(this, selectOption, option);
          if (this->delegate.didSelectOption) {
            this->delegate.didSelectOption(this, option);
          }
        }
        return true;
      }
    }
  }
 
  return super(Control, self, captureEvent, event);
}

dealloc()

static void dealloc ( Object *  self )

static

See also

Object::dealloc(Object *)

Definition at line 37 of file Select.c.

                                  {
 
  Select *this = (Select *) self;
 
  memset(&this->delegate, 0, sizeof(this->delegate));
 
  release(this->options);
  release(this->stackView);
 
  super(Object, self, dealloc);
}

init()

static View * init ( View *  self )

static

See also

View::init(View *)

Definition at line 54 of file Select.c.

                              {
  return (View *) $((Select *) self, initWithFrame, NULL);
}

initialize()

static void initialize ( Class *  clazz )

static

See also

Class::initialize(Class *)

Definition at line 456 of file Select.c.

                                     {
 
  ((ObjectInterface *) clazz->interface)->dealloc = dealloc;
 
  ((ViewInterface *) clazz->interface)->init = init;
  ((ViewInterface *) clazz->interface)->layoutSubviews = layoutSubviews;
  ((ViewInterface *) clazz->interface)->sizeThatFits = sizeThatFits;
 
  ((ControlInterface *) clazz->interface)->captureEvent = captureEvent;
  ((ControlInterface *) clazz->interface)->stateDidChange = stateDidChange;
 
  ((SelectInterface *) clazz->interface)->addOption = addOption;
  ((SelectInterface *) clazz->interface)->initWithFrame = initWithFrame;
  ((SelectInterface *) clazz->interface)->optionWithValue = optionWithValue;
  ((SelectInterface *) clazz->interface)->removeAllOptions = removeAllOptions;
  ((SelectInterface *) clazz->interface)->removeOption = removeOption;
  ((SelectInterface *) clazz->interface)->removeOptionWithValue = removeOptionWithValue;
  ((SelectInterface *) clazz->interface)->selectOption = selectOption;
  ((SelectInterface *) clazz->interface)->selectOptionWithValue = selectOptionWithValue;
  ((SelectInterface *) clazz->interface)->selectedOption = selectedOption;
  ((SelectInterface *) clazz->interface)->selectedOptions = selectedOptions;
}

initWithFrame()

static Select * initWithFrame ( Select *  self, const SDL_Rect *  frame  )

static

Definition at line 306 of file Select.c.

                                                                  {
 
  self = (Select *) super(Control, self, initWithFrame, frame);
  if (self) {
 
    self->control.selection = ControlSelectionSingle;
 
    self->options = $$(Array, arrayWithCapacity, 8);
    assert(self->options);
 
    self->stackView = $(alloc(StackView), initWithFrame, NULL);
    assert(self->stackView);
 
    $((View *) self, addSubview, (View *) self->stackView);
  }
 
  return self;
}

layoutSubviews()

static void layoutSubviews ( View *  self )

static

See also

View::layoutSubviews(View *)

Definition at line 61 of file Select.c.

                                       {
 
  Select *this = (Select *) self;
 
  Control *control = (Control *) self;
 
  if (control->selection == ControlSelectionSingle) {
 
    const Array *options = (Array *) this->options;
    for (size_t i = 0; i < options->count; i++) {
 
      Option *option = $(options, objectAtIndex, i);
      if (option->isSelected) {
        $((View *) option, setVisibility, ViewVisibilityVisible);
      } else if ($(control, isHighlighted)) {
        $((View *) option, setVisibility, ViewVisibilityVisible);
      } else {
        $((View *) option, setVisibility, ViewVisibilityHidden);
      }
    }
 
    $((View *) this->stackView, sizeToFit);
    $((View *) this->stackView, layoutIfNeeded);
 
    // Keep the expanded menu on-screen. The options are only un-hidden (and the menu
    // sized to its full height) just above, so this is the earliest point the true
    // height is known -- stateDidChange sees a collapsed, all-hidden menu. The menu
    // opens downward from the control and is parented to the window root (its frame
    // is window space); if it runs past the bottom edge, shift it up, clamped to the
    // top. Idempotent: once its bottom sits at the window edge, re-running is a no-op.
    View *menu = (View *) this->stackView;
    if ($(control, isHighlighted) && menu->window) {
 
      int windowHeight;
      SDL_GetWindowSize(menu->window, NULL, &windowHeight);
 
      const int bottom = menu->frame.y + menu->frame.h;
      if (bottom > windowHeight) {
        menu->frame.y -= (bottom - windowHeight);
        if (menu->frame.y < 0) {
          menu->frame.y = 0;
        }
      }
    }
  }
 
  super(View, self, layoutSubviews);
}

optionWithValue()

static Option * optionWithValue ( const Select *  self, const ident  value  )

static

Definition at line 336 of file Select.c.

                                                                      {
  return $((Array *) self->options, find, optionWithValue_predicate, value);
}

optionWithValue_predicate()

static bool optionWithValue_predicate ( ident  obj, ident  data  )

static

Predicate function for optionWithValue.

Definition at line 328 of file Select.c.

                                                             {
  return ((Option *) obj)->value == data;
}

removeAllOptions()

static void removeAllOptions ( Select *  self )

static

Definition at line 346 of file Select.c.

                                           {
 
  Option *option;
  while ((option = $((Array *) self->options, lastObject))) {
    $(self, removeOption, option);
  }
}

removeOption()

static void removeOption ( Select *  self, Option *  option  )

static

Definition at line 358 of file Select.c.

                                                       {
 
  if ($((Array *) self->options, containsObject, option)) {
 
    $(self->options, removeObject, option);
    $((View *) self->stackView, removeSubview, (View *) option);
 
    if (self->control.selection == ControlSelectionSingle) {
      if ($(self, selectedOption) == NULL) {
        Option *first_option = $((Array *) self->options, firstObject);
        if (first_option) {
          $(self, selectOption, first_option);
        }
      }
    }
 
    $((View *) self, setNeedsLayout);
  }
}

removeOptionWithValue()

static void removeOptionWithValue ( Select *  self, ident  value  )

static

Definition at line 382 of file Select.c.

                                                             {
 
  Option *option = (Option *) $(self, optionWithValue, value);
  if (option) {
    $(self, removeOption, option);
  }
}

selectedOption()

static Option * selectedOption ( const Select *  self )

static

Definition at line 439 of file Select.c.

                                                  {
  return $((Array *) self->options, find, selectedOptions_predicate, NULL);
}

selectedOptions()

static Array * selectedOptions ( const Select *  self )

static

Definition at line 447 of file Select.c.

                                                  {
  return $((Array *) self->options, filteredArray, selectedOptions_predicate, NULL);
}

selectedOptions_predicate()

static bool selectedOptions_predicate ( ident  obj, ident  data  )

static

Predicate for selectedOption and selectedOptions.

Definition at line 431 of file Select.c.

                                                             {
  return ((Option *) obj)->isSelected;
}

selectOption()

static void selectOption ( Select *  self, Option *  option  )

static

Definition at line 401 of file Select.c.

                                                       {
 
  if (self->control.selection == ControlSelectionSingle) {
    $((Array *) self->options, enumerate, selectOption_enumerate, NULL);
  }
 
  if (option) {
 
    if (option && option->isSelected == false) {
      $(option, setSelected, true);
    }
  }
 
  $((View *) self, setNeedsLayout);
}

selectOption_enumerate()

static void selectOption_enumerate ( const Array *  array, ident  obj, ident  data  )

static

ArrayEnumerator for enforcing ControlSelectionSingle.

Definition at line 393 of file Select.c.

                                                                              {
  $((Option *) obj, setSelected, false);
}

selectOptionWithValue()

static void selectOptionWithValue ( Select *  self, ident  value  )

static

Definition at line 421 of file Select.c.

                                                             {
 
  Option *option = $(self, optionWithValue, value);
 
  $(self, selectOption, option);
}

sizeThatFits()

static SDL_Size sizeThatFits ( const View *  self )

static

See also

View::sizeThatFits(const View *)

Definition at line 113 of file Select.c.

                                               {
 
  const Select *this = (Select *) self;
 
  SDL_Size size = super(View, self, sizeThatFits);
 
  const Array *options = (Array *) this->options;
  for (size_t i = 0; i < options->count; i++) {
 
    const View *option = $(options, objectAtIndex, i);
    const SDL_Size optionSize = $(option, sizeThatFits);
 
    size.w = max(size.w, optionSize.w + self->padding.left + self->padding.right);
    size.h = max(size.h, optionSize.h + self->padding.top + self->padding.bottom);
  }
 
  return size;
}

stateDidChange()

static void stateDidChange ( Control *  self )

static

See also

Control::stateDidChange(Control *)

Definition at line 214 of file Select.c.

                                          {
 
  Select *this = (Select *) self;
 
  if (self->selection == ControlSelectionSingle) {
 
    View *stackView = (View *) this->stackView;
 
    if ($(self, isHighlighted)) {
 
      const SDL_Rect renderFrame = $((View *) self, renderFrame);
 
      stackView->frame.x = renderFrame.x + self->view.padding.left;
      stackView->frame.y = renderFrame.y + self->view.padding.top;
 
      View *view = (View *) self;
 
      while (view->superview) {
        view = view->superview;
      }
 
      $(stackView, addClassName, "options");
      $(view, addSubview, stackView);
 
      stackView->nextResponder = (View *) self;
 
    } else {
 
      $(stackView, removeClassName, "options");
      $((View *) self, addSubview, stackView);
 
      stackView->nextResponder = NULL;
    }
 
    $(stackView, sizeToFit);
  }
 
  super(Control, self, stateDidChange);
}