HTML_QuickForm::addGroup()

HTML_QuickForm::addGroup() -- 要素グループを追加する

概要

require_once 'HTML/QuickForm.php';

object &HTML_QuickForm::addGroup (array $elements [, string $name = NULL [, mixed $groupLabel = '' [, string $separator = NULL [, string $appendName = TRUE]]]])

説明

要素グループを追加します。

パラメータ

array $elements

グループを構成する要素の配列。

string $name

(オプション) グループ名。

mixed $groupLabel

(オプション) グループのラベル。

mixed $separator

(オプション) 要素を区切るために使用する、文字列あるいは文字列の配列。

boolean $appendName

(オプション) フォーム要素の名前にグループ名を使用するかどうか、 つまり groupName[elementName] にするかそれとも elementName にするか。

返り値

追加された要素グループへの参照を返します。

例外・エラー

表 47-1PEAR_Error の値

エラーコードエラーメッセージ原因対応
QUICKFORM_INVALID_ELEMENT_NAMEElement '$elementName' already exists in HTML_QuickForm::addElement()既存の要素と同じ名前のグループを追加しようとしました。グループには別の名前を指定します。

注意

since 2.8

この関数は、スタティックにコールする ことはできません。