svn/view/view.rb


module Edmaru

  #Abstract class to implement system specific view.
  module View

    #Construct the view instance.
    #
    #=== Warning
    #This method *MUST* *NOT* be overrided in derived classes.
    #
    #=== Argument
    #_event_manager_ :: An instance of Edmaru::EventManager to handler
    #all events raised from this view.
    #
    #=== Return
    #An initialized instance of View.
    def initialize(event_manager)
      @event_manager = event_manager
      init
    end

    #The system specific initialization for this view.
    #
    #=== Warning
    #This method *MUST* be overrided in derived classes.
    def init
    end

    #Main loop to catch all events.
    #
    #=== Warning
    #This method *SHOULD* be overrided in derived classes.
    def main_loop
    end

    #Beep once.
    #
    #=== Warning
    #This method *SHOULD* be overrided in derived classes.
    def beep
      false
    end

    #Terminate this view instance.
    #
    #=== Warning
    #This method *SHOULD* be overrided in derived classes.
    def terminate
    end
  end
end