PEAR マニュアル
前のページ次のページ

HTML_QuickForm::insertElementBefore()

HTML_QuickForm::insertElementBefore() -- 新しい要素を、他の要素の直前に挿入する

概要

require_once 'HTML/QuickForm.php';

object &HTML_QuickForm::insertElementBefore (object &$element, string $nameAfter)

説明

新しい要素を、他の要素の直前に挿入します。

$element が既にフォームに追加されているかどうかを 調べる方法はありません。そのため、もし既存の要素を別の場所に移動させたいのなら removeElement() を以下のように使用する必要があります。 
$form->insertElementBefore($form->removeElement('foo', false), 'bar');

パラメータ

object &$element

挿入する要素 (HTML_QuickForm_element のインスタンス)。

string $nameAfter

直前に新しい要素を挿入することになる要素の名前。

返り値

挿入された要素への参照を返します。

例外・エラー

表 47-1PEAR_Error の値

エラーコードエラーメッセージ原因対応
QUICKFORM_INVALID_ELEMENT_NAMESeveral elements named $nameAfter exist in HTML_QuickForm::insertElementBefore() $nameAfter という名前の要素が、 フォーム内に複数存在します (例: ラジオボタン)。 このメソッドは、そのような場合に対応していません。 別の要素の前に挿入します。一意な名前を持つダミーの要素を追加することを 検討してください。
QUICKFORM_INVALID_ELEMENT_NAMEElement '$elementName' already exists in HTML_QuickForm::insertElementBefore() $element と同じ名前で、 型の違う要素が存在します。 挿入する要素に別の名前を指定します。
QUICKFORM_NONEXIST_ELEMENTElement $nameAfter does not exist in HTML_QuickForm::insertElementBefore()存在しない要素の前に挿入しようとしました。要素名の綴りを調べます。

注意

since 3.2.4

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

前のページホーム次のページ
HTML_QuickForm::getRegisteredTypes()上に戻るHTML_QuickForm::isError()