GetTextValue

Описание и параметры

string
CForm::GetTextValue(
	int answer_id,
	array answer,
	mixed form_values = false
)

Если массив, переданный в параметре form_values, инициализирован (например, в момент редактирования результата), то метод возвращает текущее значение ответа типа "text", ID которого передается в параметре answer_id.

Если массив, переданный в параметре form_values, не инициализирован (например, в момент создания нового результата), то метод вернет значение по умолчанию для данного ответа (т.е. то что задается в answer["VALUE"]).

Метод нестатический.

Параметры метода

Параметр	Описание
answer_id	ID ответа.
answer	Массив, описывающий параметры ответа, обязательным элементом которого является элемент с ключом VALUE и со значением в котором содержится значение по умолчанию для ответа. Как правило таким значением по умолчанию становится параметр ANSWER_VALUE ответа.
form_values	Ассоциированный массив значений, пришедших с веб-формы при создании нового или редактировании существующего результата (стандартный массив $_REQUEST). Данный массив может быть также получен с помощью метода CFormResult::GetDataByIDForHTML. Параметр необязательный. По умолчанию - "false".

Смотрите также

CForm::GetTextField

Примеры использования

<?
/*******************************************
       Редактирование результата
*******************************************/

$RESULT_ID = 12; // ID результата

// если была нажата кнопка "Сохранить" то
if (strlen($_REQUEST["save"])>0)
{
	// используем данные пришедшие с формы
	$arrVALUES = $_REQUEST; 
}
else
{
	// сформируем этот массив из данных по результату
	$arrVALUES = CFormResult::GetDataByIDForHTML($RESULT_ID); 
}
?>
<form action="" method="POST">
<table>
	<tr>
		<td>Фамилия:</td>
		<td><?

			// массив описывающий однострочное текстовое поле
			// содержит минимально-необходимые поля
			$arAnswer = array(
				"ID"            => 586,   // ID поля для ответа на вопрос "Ваша фамилия?"
				"VALUE"         => "",    // параметр ANSWER_VALUE (значение по умолчанию)
				"FIELD_WIDTH"   => 10,    // ширина поля
				"FIELD_PARAM"   => ""     // параметры поля
			);

			// получим текущее значение
			$value = CForm::GetTextValue($arAnswer["ID"], $arAnswer, $arrVALUES);

			// выведем поле
			echo CForm::GetTextField(
				$arAnswer["ID"],
				$value,
				$arAnswer["FIELD_WIDTH"],
				$arAnswer["FIELD_PARAM"]
			);
		?></td>
	</tr>
</table>
<input type="submit" name="save" value="Сохранить">
</form>