Issue #570314 follow-up by jhodgdon, Mac_Weber: Fixed form_set_value() documentation needs more detail.

merge-requests/26/head
webchick 2011-10-24 20:07:48 -07:00
parent c545f6eedd
commit 168bd186a6
1 changed files with 4 additions and 2 deletions

View File

@ -2404,11 +2404,13 @@ function form_type_token_value($element, $input = FALSE) {
}
/**
* Change submitted form values during form validation.
* Changes submitted form values in $form_state.
*
* Use this function to change the submitted value of a form element in a form
* validation function, so that the changed value persists in $form_state
* through to the submission handlers.
* through the remaining validation and submission handlers. It does not change
* the value in $element['#value'], only in $form_state['values'], which is
* where submitted values are always stored.
*
* Note that form validation functions are specified in the '#validate'
* component of the form array (the value of $form['#validate'] is an array of