rtml 1.2.2

data/app_generators/rtml/templates/rtml/lib/rtml/widgets/widget_class_methods.rb

@@ -0,0 +1,213 @@
+module Rtml::Widgets::WidgetClassMethods
+  @@accessor_aliases = { }
+  @@accessor_lists = { }
+  @@property_callbacks = { }
+  @@legal_accessors = [ Rtml::Core::Screen,
+                        Rtml::Core::TMLDocument, Rtml::Widgets::Widget ]
+  
+  # Creates a Property for this Widget. Each argument in the
+  # method call should be the name of the argument to be created.
+  # You can also pass a callback method name, in the form of a hash
+  # (:property_name => :callback_name), which will be called whenever
+  # a value is assigned to the property. The return value from that
+  # callback will be the value that is finally assigned to the property.
+  #
+  # You can also pass an array of callbacks. They will be called in order,
+  # and each subsequent callback will be called with the value returned
+  # from the one before it. When all callbacks have fired, the final value
+  # will be assigned to the property.
+  #
+  # See also #init_properties
+  #
+  # Examples:
+  #   property :first_name, :last_name
+  #   property :zip_code => :force_integer
+  #   property :state => [ :force_uppercase, :check_valid_state ]
+  #
+  def property(*props)
+    props.each do |prop|
+      prop = { prop => nil } unless prop.kind_of? Hash # Give it a nil callback if it needs one
+      prop.each do |prop_name, callback|
+        callbacks = add_callback_for prop_name, callback
+
+        raise "Cannot create property #{prop_name}: method already exists!" if self.instance_methods.include? prop_name.to_s
+        
+        b = class_eval("binding")
+        eval "def #{prop_name}(*a,&b); access_property(#{prop_name.inspect}, *a, &b); end", b, __FILE__, __LINE__
+        eval "def #{prop_name}=(a,&b); set_property_value(#{prop_name.inspect}, a, &b); end", b, __FILE__, __LINE__
+      end
+    end
+    nil
+  end
+
+  # Adds a callback for a given property
+  def add_callback_for(prop_name, callback)
+    callbacks_for(prop_name.to_s) << callback
+    callbacks_for(prop_name.to_s).flatten!
+    callbacks_for(prop_name.to_s).delete nil # no nils allowed
+    callbacks_for(prop_name.to_s)
+  end
+  
+  # Returns all registered callbacks for the given property
+  def callbacks_for(prop_name)
+    @@property_callbacks[self.name] ||= {}
+    if prop_name then @@property_callbacks[self.name][prop_name.to_s] ||= []
+    else @@property_callbacks
+    end
+  end
+  
+  
+  # Creates an alias within the specified accessor (Screen, TMLDocument, or another Widget)
+  # which points to this Widget. For example, suppose we have a Widget called DefaultErrorMessageWidget.
+  # To call this Widget from a Screen, the user would have to use:
+  #
+  #   screen.default_error_message_widget { . . . }
+  #
+  # Thus making for some tired fingers if there are a lot of error messages. But, if you add
+  # the following line to your Widget source:
+  #
+  #   accessor_alias :def_err_msg
+  #
+  # Then the user only has to type:
+  #
+  #   screen.def_err_msg { . . . }
+  # 
+  # Which makes life that much easier for the user.
+  # All Widgets, when generated, contain an alias to remove the "_widget" part of their name
+  # from an Accessor.
+  #
+  # Multiple aliases can be specified on a single line:
+  #
+  #   accessor_alias :def_err_msg, :default_error
+  #
+  # Or on separate lines:
+  #
+  #   accessor_alias :def_err_msg
+  #   accessor_alias :default_error
+  #
+  def accessor_alias(*args)
+    self.accessor_aliases.concat args
+    define_aliases
+  end
+  
+  # Returns the hash of all accessors for this Widget, or for the specified Widget
+  # if its name is given.
+  def accessor_aliases(name = self.name)
+    @@accessor_aliases ||= {}
+    @@accessor_aliases[name] ||= [ ] unless name.nil?
+    if name then @@accessor_aliases[name]
+    else @@accessor_aliases
+    end
+  end
+  
+  # Specifies the name of an Accessor, which is a TML object that can reference this
+  # Widget. An exception will be raised when the Widget is loaded, if this is not specified
+  # at least once within your Widget class. An Accessor includes any of the built-in
+  # parent objects (TMLDocument, Screen, Display) as well as any other Widgets in existence.
+  # This should be a Class object, NOT a Symbol or String!
+  #
+  # It is also important to note that,
+  # while any Widget can be specified as an Accessor, it is up to that Widget to actually
+  # make room for your Widget. If the user adds your Widget to a CallFuncWidget, and you
+  # have specified CallFuncWidget as a valid accessor,
+  # it will compile, but it will have no effect because the Confirmation widget does not
+  # call the render_widget_tml method (exposed by the Rtml::Helpers::WidgetSupport module).
+  #
+  # Examples:
+  #   accessor TMLDocument
+  #   accessor Screen, Display
+  #   accessor ConfirmationWidget
+  #
+  # You can make your Widget accessible from ANY other Widget by specifying the Widget
+  # base class itself as an accessor:
+  #   accessor Widget
+  #
+  # You can also add all of the base TML objects by adding their parent class as an accessor:
+  #   accessor Element
+  #
+  # Note that the Element class is slightly misleading, because ONLY the built-in types
+  # count as Elements! A Widget is not an Element, even though it does produce TML.
+  def accessor(*args)
+    check_accessibility(args)
+    add_accessor self, args
+    @@legal_accessors << self
+    self.accessor_list.concat [ args ].flatten
+    define_aliases
+  end
+
+  # Requests the list of Accessors for this Widget, built using the #accessor method.
+  # The return value is an Array containing the Class objects for each Accessor.
+  #
+  # If a Widget name is specified, the accessor list for that Widget will be retrieved.
+  def accessor_list(name = self.name)
+    @@accessor_lists ||= {}
+    @@accessor_lists[name] ||= [] unless name.nil?
+    if name then @@accessor_lists[name]
+    else @@accessor_lists
+    end
+  end
+  
+  # Returns true if the specified name is an accessor for this Widget, or for the target
+  # Widget if a name is given.
+  def is_accessor?(name, target = self.name)
+    accessor_aliases(target).each do |als|
+      return true if als == name
+    end
+    false
+  end
+
+  # Override this method if you need to disable assigning properties from
+  # the hash supplied to the Widget constructor. This does not apply to
+  # assignments made in block form, but can be useful if your Widget requires
+  # the user to pass keys into the hash that may not correlate to properties
+  # within the Widget itself.
+  def assign_properties?
+    true
+  end
+
+  def add_accessor(target, accessors)
+    accessors.flatten.each do |kls|
+      #kls.class_eval "def #{access_name}(*args, &blk); add_widget(#{target}, *args, &blk); end"
+      eval "def #{access_name}(*args, &blk); add_widget(#{target}, *args, &blk); end", kls.class_eval("binding"), __FILE__, __LINE__
+    end
+  end
+  
+  def define_aliases
+    return if self.accessor_list.nil?
+    return if self.accessor_aliases.nil?
+    accessor_list.each do |kls|
+      accessor_aliases.each do |als|
+        code = ""
+        unless silence_accessor_failures?
+          code = <<-end_code
+            Rails.logger.warn Rtml::Errors::WidgetAccessorFailure.new(#{als.inspect}, #{self.name.inspect}, self) unless access_point_valid? #{als.inspect}
+          end_code
+        end
+        code += <<-end_code
+          #{code}
+          def #{als}(*args, &blk)
+            #{access_name}(*args, &blk)
+          end
+        end_code
+        #"
+        begin
+          eval code, kls.class_eval("binding"), __FILE__, __LINE__
+        rescue Rtml::Errors::WidgetAccessorFailure
+          raise $! unless kls.silence_accessor_failures?
+        end
+      end
+    end
+  end
+  
+  def access_name
+    self.name.underscore.downcase.gsub(/.*\//, '')
+  end
+  
+  def check_accessibility(accessibility)
+    raise "Must supply one or more accessors (one of #{@@legal_accessors.join(", ")})" if accessibility.length == 0
+    accessibility.flatten.each do |kls|
+      raise "Accessor object #{kls} must be a Class" unless kls.class == Class
+      raise "Accessor #{kls} is not a legal accessor (one of #{@@legal_accessors.join(',')})" unless @@legal_accessors.include? kls
+    end
+  end
+end

data/app_generators/rtml/templates/rtml/public/stylesheets/rtml/beryl_color.css

@@ -0,0 +1,37 @@
+.menu{text-indent: 15%;}
+div.title{background-color: #000000; color: #FFFFFF; width: 100%; margin: 2px;}
+span.title{background-color: #000000; color: #FFFFFF; font-size: large; font-weight: bold; text-align: center; vertical-align: middle;}
+span.center{vertical-align: middle; text-align: center;}
+div.message{height: 100%; }
+span.message{ font-size: large; text-align: center;}
+span{font-size: large;}
+screen{font-size: large;}
+h1{text-align: center;}
+table.message{text-align: center; vertical-align: middle; height: 100%; width: 100%;}
+table.warning{text-align: center; vertical-align: middle; height: 100%; width: 100%;}
+th{text-align: center; vertical-align: middle;}
+table.menu{height: 100%; width: 100%; vertical-align: middle; text-align: center; font-size: large;}
+table.menu2{vertical-align: middle; font-size: large;}
+div.menu{height: 100%; width: 100%; vertical-align: middle; text-align: center; font-size: large;}
+
+
+.c_bold { font-weight: bold;}
+.c_small { font-size: small;}
+.c_large { font-size: large; text-align: left;}
+.c_bold_large { font-weight: bold; font-size: large; text-align: left;}
+.c_bold_large_center { font-weight: bold; font-size: large; text-align: center;}
+.c_bold_red_large { font-weight: bold; font-size: large; text-align: left; color: #FF0000;}
+.c_right { text-align: right;}
+.c_left { text-align: left; }
+.c_center { text-align: center;}
+.c_warn { color: #FF0000; text-align: center; font-weight: bold;}
+.c_href_menu { font-family: helvetica; font-size: large; text-indent: 2%; vertical-align: middle;}
+
+.c_prn { font-size: medium; text-align: left; }
+
+.c_image_middle {vertical-align: middle;}
+
+pre { white-space: pre; }
+
+h1 { font-weight: bold; font-size: large; text-align: left;}
+h2 { font-weight: bold; font-size: medium; text-align: left;}

data/app_generators/rtml/templates/rtml/public/stylesheets/rtml/beryl_mono.css

@@ -0,0 +1,17 @@
+.menu{text-indent: 15%;}
+div.title{background-color: #000000; color: #FFFFFF; width: 100%; margin: 1px;}
+span.title{background-color: #000000; color: #FFFFFF; font-size: x-small; font-weight: bold; text-align: center; vertical-align: middle;}
+span.center{vertical-align: middle; text-align: center;}
+div.message{height: 100%; }
+span.message{ font-size: x-small; text-align: center;}
+span{font-size: x-small;}
+screen{font-size: x-small;}
+h1{text-align: center;}
+table.message{text-align: center; vertical-align: middle; height: 100%; width: 100%;}
+table.warning{text-align: center; vertical-align: middle; height: 100%; width: 100%;}
+div.menu{ width: 100%; text-align: left; font-size: medium; text-indent: 15%;}
+
+.bold { font-weight: bold; }
+.large { font-size: large; }
+.small { font-size: small; }
+

data/app_generators/rtml/templates/rtml/public/stylesheets/rtml/oe/btmlpa/i5100.css

@@ -0,0 +1,12 @@
+.menu{text-indent: 15%;}
+div.title{background-color: #000000; color: #FFFFFF; width: 100%; margin: 2px;}
+span.title{background-color: #000000; color: #FFFFFF; font-size: medium; font-weight: bold; text-align: center; vertical-align: middle;}
+span.center{vertical-align: middle; text-align: center;}
+div.message{height: 100%; }
+span.message{ font-size: medium; text-align: center;}
+span{font-size: medium;}
+screen{font-size: medium;}
+h1{text-align: center;}
+table.message{text-align: center; vertical-align: middle; height: 100%; width: 100%;}
+table.warning{text-align: center; vertical-align: middle; height: 100%; width: 100%;}
+div.menu{ width: 100%; text-align: left; font-size: medium; text-indent: 15%;}

data/app_generators/rtml/templates/rtml/public/stylesheets/rtml/oe/btmlpa/i8550.css

@@ -0,0 +1,37 @@
+.menu{text-indent: 15%;}
+div.title{background-color: #000000; color: #FFFFFF; width: 100%; margin: 2px;}
+span.title{background-color: #000000; color: #FFFFFF; font-size: large; font-weight: bold; text-align: center; vertical-align: middle;}
+span.center{vertical-align: middle; text-align: center;}
+div.message{height: 100%; }
+span.message{ font-size: large; text-align: center;}
+span{font-size: large;}
+screen{font-size: large;}
+h1{text-align: center;}
+table.message{text-align: center; vertical-align: middle; height: 100%; width: 100%;}
+table.warning{text-align: center; vertical-align: middle; height: 100%; width: 100%;}
+th{text-align: center; vertical-align: middle;}
+table.menu{height: 100%; width: 100%; vertical-align: middle; text-align: center; font-size: large;}
+table.menu2{vertical-align: middle; font-size: large;}
+div.menu{height: 100%; width: 100%; vertical-align: middle; text-align: center; font-size: large;}
+
+
+.c_bold { font-weight: bold;}
+.c_small { font-size: small;}
+.c_large { font-size: large; text-align: left;}
+.c_bold_large { font-weight: bold; font-size: large; text-align: left;}
+.c_bold_large_center { font-weight: bold; font-size: large; text-align: center;}
+.c_bold_red_large { font-weight: bold; font-size: large; text-align: left; color: #FF0000;}
+.c_right { text-align: right;}
+.c_left { text-align: left; }
+.c_center { text-align: center;}
+.c_warn { color: #FF0000; text-align: center; font-weight: bold;}
+.c_href_menu { font-family: helvetica; font-size: large; text-indent: 2%; vertical-align: middle;}
+
+.c_prn { font-size: medium; text-align: left; }
+
+.c_image_middle {vertical-align: middle;}
+
+pre { white-space: pre; }
+
+h1 { font-weight: bold; font-size: large; text-align: left;}
+h2 { font-weight: bold; font-size: medium; text-align: left;}

data/app_generators/rtml/templates/rtml/public/stylesheets/rtml/oe/btmlpa/receipt.css

@@ -0,0 +1,4 @@
+table.receipt { text-align: left; width: 100%; margin-left: 10px; margin-right: 10px; margin-top: 40px; margin-bottom: 60px;}
+p.amount{font-size: large; font-weight: bold}
+table.warning{text-align: center; vertical-align: middle; height: 100%; width: 100%;}
+span.bold{font-weight: bold;}

data/app_generators/rtml/templates/rtml/public/stylesheets/rtml/oe/examples/i5100.css

@@ -0,0 +1,12 @@
+.menu{text-indent: 15%;}
+div.title{background-color: #000000; color: #FFFFFF; width: 100%; margin: 2px;}
+span.title{background-color: #000000; color: #FFFFFF; font-size: medium; font-weight: bold; text-align: center; vertical-align: middle;}
+span.center{vertical-align: middle; text-align: center;}
+div.message{height: 100%; }
+span.message{ font-size: medium; text-align: center;}
+span{font-size: medium;}
+screen{font-size: medium;}
+h1{text-align: center;}
+table.message{text-align: center; vertical-align: middle; height: 100%; width: 100%;}
+table.warning{text-align: center; vertical-align: middle; height: 100%; width: 100%;}
+div.menu{ width: 100%; text-align: left; font-size: medium; text-indent: 15%;}

data/app_generators/rtml/templates/rtml/public/stylesheets/rtml/oe/examples/i8550.css

@@ -0,0 +1,37 @@
+.menu{text-indent: 15%;}
+div.title{background-color: #000000; color: #FFFFFF; width: 100%; margin: 2px;}
+span.title{background-color: #000000; color: #FFFFFF; font-size: large; font-weight: bold; text-align: center; vertical-align: middle;}
+span.center{vertical-align: middle; text-align: center;}
+div.message{height: 100%; }
+span.message{ font-size: large; text-align: center;}
+span{font-size: large;}
+screen{font-size: large;}
+h1{text-align: center;}
+table.message{text-align: center; vertical-align: middle; height: 100%; width: 100%;}
+table.warning{text-align: center; vertical-align: middle; height: 100%; width: 100%;}
+th{text-align: center; vertical-align: middle;}
+table.menu{height: 100%; width: 100%; vertical-align: middle; text-align: center; font-size: large;}
+table.menu2{vertical-align: middle; font-size: large;}
+div.menu{height: 100%; width: 100%; vertical-align: middle; text-align: center; font-size: large;}
+
+
+.c_bold { font-weight: bold;}
+.c_small { font-size: small;}
+.c_large { font-size: large; text-align: left;}
+.c_bold_large { font-weight: bold; font-size: large; text-align: left;}
+.c_bold_large_center { font-weight: bold; font-size: large; text-align: center;}
+.c_bold_red_large { font-weight: bold; font-size: large; text-align: left; color: #FF0000;}
+.c_right { text-align: right;}
+.c_left { text-align: left; }
+.c_center { text-align: center;}
+.c_warn { color: #FF0000; text-align: center; font-weight: bold;}
+.c_href_menu { font-family: helvetica; font-size: large; text-indent: 2%; vertical-align: middle;}
+
+.c_prn { font-size: medium; text-align: left; }
+
+.c_image_middle {vertical-align: middle;}
+
+pre { white-space: pre; }
+
+h1 { font-weight: bold; font-size: large; text-align: left;}
+h2 { font-weight: bold; font-size: medium; text-align: left;}