Документация для разработчиков
Темная тема

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".

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

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

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

$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>


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2020, «1С-Битрикс», 2020
Наверх