Приложения

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

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

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

А.5.28.34. Макрос rdsFORMGetString – получение значения поля ввода в виде строки

Макрос rdsFORMGetString возвращает значение указанного поля ввода в виде строки.

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

Определение

  #define rdsFORMGetStringA(win,ctrlid) \
    rdsGetObjectStrA((win),(ctrlid),RDS_FORMVAL_VALUE)
  #define rdsFORMGetStringW(win,ctrlid) \
    rdsGetObjectStrW((win),(ctrlid),RDS_FORMVAL_VALUE)
  // Через функцию-псевдоним
  #define rdsFORMGetString(win,ctrlid) \
    rdsGetObjectStr((win),(ctrlid),RDS_FORMVAL_VALUE)

Параметры

win (RDS_HOBJECT)

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

ctrlid (int)

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

Возвращаемое значение

Указатель на строку значения поля ввода ctrlid во внутренней памяти объекта win.

Примечания

Этот макрос заключает в себя вызов команды RDS_FORMVAL_VALUE с использованием функции rdsGetObjectStr. Указатель, возвращенный макросом, будет действительным до следующего изменения значения поля ввода.