Текущий раздел:

Описания RDS

Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.28. Вспомогательный объект для работы с модальными окнами

А.5.28.18. Команда RDS_FORMVAL_LIST – установка списка вариантов

# Приложения

## Приложение А. Функции, константы и структуры RDS

### А.5. Сервисные функции и макросы RDS

#### А.5.28. Вспомогательный объект для работы с модальными окнами

##### А.5.28.18. Команда RDS_FORMVAL_LIST – установка списка вариантов

Команда RDS_FORMVAL_LIST служит для установки списка вариантов выпадающего списка в полях ввода типа RDS_FORMCTRL_COMBOLIST, RDS_FORMCTRL_COMBOEDIT и RDS_FORMCTRL_LISTANDEDIT, а также для установки списка шаблонов имен файлов для кнопок вызова диалогов открытия и закрытия файла RDS_FORMCTRL_OPENDIALOG и RDS_FORMCTRL_SAVEDIALOG соответственно.

Вызов команды

      int iCtrlId= …    // Идентификатор поля ввода
      RDSCSTR sList= …  // Строка списка (UTF8)
      rdsSetObjectStrA(Win,iCtrlId,RDS_FORMVAL_LIST,sList);

или

      int iCtrlId= …    // Идентификатор поля ввода
      RDSWCSTR sList= … // Строка списка (UTF16)
      rdsSetObjectStrW(Win,iCtrlId,RDS_FORMVAL_LIST,sList);

или (через функцию-псевдоним)

      int iCtrlId= …    // Идентификатор поля ввода
      RDSXCSTR sList= … // Строка списка (кодировка по умолчанию)
      rdsSetObjectStr(Win,iCtrlId,RDS_FORMVAL_LIST,sList);

Параметры

Win(RDS_HOBJECT)
  Идентификатор вспомогательного объекта для работы с модальным окном, ранее созданного функцией rdsFORMCreate.
iCtrlId(int)
  Целый идентификатор поля ввода, присвоенный ему при вызове функции rdsFORMAddEdit.
sList(RDSCSTR,RDSWCSTR,RDSXCSTR)
  Указатель на строку, содержащую список вариантов или список шаблонов имен файлов.

Примечания

Эта команда передает список строк в поля ввода, которым такой список необходим для работы. В зависимости от типа поля этот список устроен по-разному, но его строки всегда разделяются символом перевода строки «\n» с кодом 10. Для полей ввода с выпадающими списками (RDS_FORMCTRL_COMBOLIST, RDS_FORMCTRL_COMBOEDIT, RDS_FORMCTRL_LISTANDEDIT) каждая строка списка содержит один вариант: например, для выпадающего списка с вариантами «Ручной», «Полуавтоматический» и «Автоматический» передается строка «Ручной\nПолуавтоматический\nАвтоматический». Для полей, которым требуются шаблоны имен файлов, каждая строка списка содержит один шаблон, который состоит из названия, видимого пользователю, символа вертикальной черты «|» и набора масок имен файлов, разделенных точкой с запятой. Например, если требуется указать два шаблона, один из которых будет отображать в диалоге только текстовые файлы с расширениями «txt» и «log», а другой – все файлы, в поле ввода передается строка «Текстовые файлы|*.txt;*.log\nВсе файлы|*.*».

Пример

Примеры использования команды RDS_FORMVAL_LIST приведены в руководстве программиста: в §2.7.2 (для поля с выпадающим списком) и в §2.13.6 (для задания шаблонов имен файлов).

См. также

RDS_FORMCTRL_COMBOLIST, RDS_FORMCTRL_COMBOEDIT, RDS_FORMCTRL_LISTANDEDIT, RDS_FORMCTRL_OPENDIALOG, RDS_FORMCTRL_SAVEDIALOG, rdsFORMCreate, rdsFORMAddEdit, rdsSetObjectStr.