previousHTML_QuickForm::getRegisteredTypes() (Previous) (Next) HTML_QuickForm::isError()next

View this page in Last updated: Sun, 18 Oct 2009
English | Brazilian Portuguese | Chinese | Dutch | French | German | Hungarian | Japanese | Polish | Russian | Spanish | Turkish

HTML_QuickForm::insertElementBefore()

HTML_QuickForm::insertElementBefore() – Insert un nouvel élément avant un autre élément

Synopsis

require_once 'HTML/QuickForm.php';

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

Description

Insert un nouvel élément avant un autre élément.

Il n'est pas possible de vérifier si l'élément $element a déjà été ajouté au formulaire, toutefois, si vous voulez déplacer l'élément existant du formulaire à une nouvelle position, vous devez utiliser la méthode removeElement() :

<?php
$form
->insertElementBefore($form->removeElement('foo'false), 'bar');
?>

Parameter

object &$element

Élément à insérer (une instance de HTML_QuickForm_element)

string $nameAfter

Nom de l'élément par rapport auquel le nouveau sera inséré

Return value

Retourne une référence sur l'élément inséré.

Throws

Possible PEAR_Error values
Code erreur Message d'erreur Raison Solution
QUICKFORM_INVALID_ELEMENT_NAME Several elements named $nameAfter exist in HTML_QuickForm::insertElementBefore() Plusieurs éléments nommés $nameAfter (e.g.: radios) existent dans le formulaire. La méthode ne gère pas ce cas. Insérer avant d'autres éléments. Ajoutez un élément avec un nom unique.
QUICKFORM_INVALID_ELEMENT_NAME Element '$elementName' already exists in HTML_QuickForm::insertElementBefore() Un élément existe avec le même nom que $element mais avec un type différent Donnez un nom différent à l'élémentà insérer.
QUICKFORM_NONEXIST_ELEMENT Element $nameAfter does not exist in HTML_QuickForm::insertElementBefore() Tentative d'insertion avant un élément non existant Vérifiez le nom de l'élément

Note

Disponible depuis la version 3.2.4.

This function can not be called statically.

previousHTML_QuickForm::getRegisteredTypes() (Previous) (Next) HTML_QuickForm::isError()next

Download Documentation Last updated: Sun, 18 Oct 2009
Do you think that something on this page is wrong? Please file a bug report or add a note.
User Notes:
There are no user contributed notes for this page.