Sitellite Application Framework
Class Tree         Index         All Elements

Class: MF_Widget_timeinterval

Source Location: Program_Root/MailForm/Widget/Timeinterval.php

Class Overview

MF_Widget
   |
   --MF_Widget_timeinterval

Timeinterval widget. Displays 3 select boxes which represent the hour (1 through 12), the minutes (:00, :15, :30, and :45), and AM/PM.


Author(s)

Version

  • 1.6, 2002-08-25, $Id: Timeinterval.php,v 1.2 2005/07/06 15:30:56 lux Exp $

Copyright

  • Copyright (C) 2001-2003, Simian Systems Inc.

Variables

Methods


Inherited Variables

Inherited Methods

Class: MF_Widget

MF_Widget::MF_Widget()
Constructor Method.
MF_Widget::addRule()
Adds a validation rule to the list of $rules.
MF_Widget::attr()
This is the accessor method for setting and getting the value of
MF_Widget::changeType()
MF_Widget::display()
Returns the display HTML for this widget. The optional parameter determines whether or not to automatically display the widget nicely, or whether to simply return the widget (for use in a template).
MF_Widget::getAttrs()
Returns a list of all of the attributes of this object's HTML tag in a string ready to be concatenated into the actual rendered tag output.
MF_Widget::getValue()
Fetches the actual value for this widget.
MF_Widget::invalid()
Returns a ' class="invalid"' string if the widget's $invalid property is set to true, or an empty string otherwise.
MF_Widget::setDefault()
Sets the default value for the widget.
MF_Widget::setValue()
Sets the *ACTUAL* value for this widget. An optional second parameter can be passed, which is unused here, but can be used in complex widget types to assign parts of a value and piece it together from multiple physical form fields.
MF_Widget::setValues()
Sets the *POSSIBLE* values for this widget. If $value is given, sets $this->value as a hash, otherwise, as a string.
MF_Widget::unsetAttr()
Use this method to remove an attribute from the tag
MF_Widget::validate()
Validates the widget against its set of $rules. Returns false on failure to pass any rule.
MF_Widget::validation()
Sets the validation $rule for this widget. Note: This method is deprecated and only wraps around the addRule() method anyway. Please use addRule() instead, since this method will be removed in a near-future release.

Class Details

[line 58]
Timeinterval widget. Displays 3 select boxes which represent the hour (1 through 12), the minutes (:00, :15, :30, and :45), and AM/PM.

New in 1.2:

  • Added a setDefault(value) method.
New in 1.4:
  • Changed parseTime() to use the Date package's roundTime() method.
New in 1.6:
  • Added automatic I18n (if $intl object exists) calls in display() to allow for translations of nullable names.

1 <?php
2
3 $widget = new MF_Widget_timeinterval ('name');
4 $widget->validation ('is "foo"');
5 $widget->setValue ('foo');
6 $widget->error_message = 'Oops! This widget is being unruly!';
7
8 ? >




Tags:

access:  public
version:  1.6, 2002-08-25, $Id: Timeinterval.php,v 1.2 2005/07/06 15:30:56 lux Exp $
license:  http://www.sitellite.org/index/license
copyright:  Copyright (C) 2001-2003, Simian Systems Inc.
author:  John Luxford <mailto:lux@simian.ca>


[ Top ]


Class Variables

$extra =  ''

[line 93]

A way to pass extra parameters to the HTML form tag, for example 'enctype="multipart/formdata"'.



Tags:

access:  public

Type:   mixed


[ Top ]

$type =  'timeinterval'

[line 102]

This is the short name for this widget. The short name is the class name minus the 'MF_Widget_' prefix.



Tags:

access:  public

Type:   mixed
Overrides:   Array


[ Top ]



Class Methods


constructor MF_Widget_timeinterval [line 111]

MF_Widget_timeinterval MF_Widget_timeinterval( string $name)

Constructor Method.



Tags:

access:  public


Parameters:

string   $name  

[ Top ]

method display [line 247]

string display( [boolean $generate_html = 0])

Returns the display HTML for this widget. The optional parameter determines whether or not to automatically display the widget nicely, or whether to simply return the widget (for use in a template).



Tags:

access:  public


Overrides MF_Widget::display() (Returns the display HTML for this widget. The optional parameter determines whether or not to automatically display the widget nicely, or whether to simply return the widget (for use in a template).)

Parameters:

boolean   $generate_html  

[ Top ]

method getValue [line 217]

string getValue( [object $cgi = ''])

Fetches the actual value for this widget.



Tags:

access:  public


Overrides MF_Widget::getValue() (Fetches the actual value for this widget.)

Parameters:

object   $cgi  

[ Top ]

method makeTime [line 192]

string makeTime( string $hour, string $minute, string $ampm)

Takes your hour, minute and ampm values (used internally), and returns a time string of the format HH:MM:SS.



Tags:

access:  public


Parameters:

string   $hour  
string   $minute  
string   $ampm  

[ Top ]

method parseTime [line 165]

array parseTime( string $time)

Parses a time string (format: HH:MM:SS) and returns the hour, minute and ampm values for internal use with this widget.



Tags:

access:  public


Parameters:

string   $time  

[ Top ]

method setDefault [line 233]

void setDefault( string $value)

Gives this widget a default value. Accepts a time string of the format 'HH:MM:SS'.



Tags:

access:  public


Overrides MF_Widget::setDefault() (Sets the default value for the widget.)

Parameters:

string   $value  

[ Top ]

method setValue [line 139]

void setValue( [string $value = ''], [string $inner_component = ''])

Sets the actual value for this widget. An optional second parameter can be passed, which is unused here, but can be used in complex widget types to assign parts of a value and piece it together from multiple physical form fields.



Tags:

access:  public


Overrides MF_Widget::setValue() (Sets the *ACTUAL* value for this widget. An optional second parameter can be passed, which is unused here, but can be used in complex widget types to assign parts of a value and piece it together from multiple physical form fields.)

Parameters:

string   $value  
string   $inner_component  

[ Top ]


Copyright © 2007, SIMIAN systems Inc.
All rights reserved. Privacy policy
Documentation generated on Tue, 13 Feb 2007 17:19:57 -0600 by Sitellite AppDoc and phpDocumentor 1.2.2