Sitellite Application Framework
Class Tree         Index         All Elements

Class: MF_Widget_set

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

Class Overview

MF_Widget
   |
   --MF_Widget_set

Set widget. Displays a text box with a select box next to it of previously entered values. This creates the equivalent of a select box that also allows new values to be entered.


Author(s)

Version

  • 1.0, 2003-01-09, $Id: Set.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 50]
Set widget. Displays a text box with a select box next to it of previously entered values. This creates the equivalent of a select box that also allows new values to be entered.


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




Tags:

access:  public
version:  1.0, 2003-01-09, $Id: Set.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 58]

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



Tags:

access:  public

Type:   mixed


[ Top ]

$type =  'set'

[line 67]

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_set [line 76]

MF_Widget_set MF_Widget_set( string $name)

Constructor Method.



Tags:

access:  public


Parameters:

string   $name  

[ Top ]

method display [line 186]

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 148]

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 setDefault [line 172]

void setDefault( string $value)

Gives this widget a default value. Accepts a date string of the format 'YYYY-MM-DD'.



Tags:

access:  public


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

Parameters:

string   $value  

[ Top ]

method setValue [line 105]

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 ]

method setValues [line 125]

boolean setValues( string $table)

Sets the *POSSIBLE* values for this widget. Uses

the specified $table to find out all of the existing values of this field, which will be displayed in the inner select box. Returns true or false, and sets the $error property if a database error occurs.




Tags:

access:  public


Overrides MF_Widget::setValues() (Sets the *POSSIBLE* values for this widget. If $value is given, sets $this->value as a hash, otherwise, as a string.)

Parameters:

string   $table  

[ Top ]


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