Приложения

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

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

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

А.5.28.36. Макрос rdsFORMSetComboList – установка списка вариантов

Макрос rdsFORMSetComboList заносит в указанное поле ввода список вариантов для выпадающего списка или список шаблонов имен файлов для кнопок открытия и сохранения файла.

  rdsFORMSetComboListA(
    win,       // Вспомогательный объект-окно
    ctrlid,    // Идентификатор поля ввода
    list       // Список (UTF8)
  )
  rdsFORMSetComboListW(
    win,       // Вспомогательный объект-окно
    ctrlid,    // Идентификатор поля ввода
    list       // Список (UTF16)
  )
  // Через функцию-псевдоним
  rdsFORMSetComboList(
    win,       // Вспомогательный объект-окно
    ctrlid,    // Идентификатор поля ввода
    list       // Список (кодировка по умолчанию)
  )

Определение

  #define rdsFORMSetComboList(win,ctrlid,list) \
    rdsSetObjectStrA((win),(ctrlid),RDS_FORMVAL_LIST,(list))
  #define rdsFORMSetComboList(win,ctrlid,list) \
    rdsSetObjectStrW((win),(ctrlid),RDS_FORMVAL_LIST,(list))
  // Через функцию-псевдоним
  #define rdsFORMSetComboList(win,ctrlid,list) \
    rdsSetObjectStr((win),(ctrlid),RDS_FORMVAL_LIST,(list))

Параметры

win (RDS_HOBJECT)

Идентификатор вспомогательного объекта для работы с модальным окном, ранее созданного функцией rdsFORMCreate.

ctrlid (int)

Целый идентификатор поля ввода, присвоенный ему при вызове функции rdsFORMAddEdit.

list (RDSCSTR, RDSWCSTR, RDSXCSTR)

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

Примечания

Этот макрос заключает в себя вызов команды RDS_FORMVAL_LIST с использованием функции rdsSetObjectStr.