Приложения

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

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

А.5.5. Вызов стандартных диалогов

А.5.5.5. rdsInputString – окно ввода строки

Функция rdsInputString открывает универсальный диалог для ввода одной строки.

  RDSSTR RDSCALL rdsInputStringA( // UTF8
    RDSCSTR WinCaption,  // Заголовок окна (UTF8)
    RDSCSTR StrCaption,  // Заголовок поля ввода (UTF8)
    RDSCSTR Default,     // Исходное значение (UTF8)
    int Width            // Ширина поля ввода
  );
  RDSWSTR RDSCALL rdsInputStringW( // UTF16
    RDSWCSTR WinCaption, // Заголовок окна (UTF16)
    RDSWCSTR StrCaption, // Заголовок поля ввода (UTF16)
    RDSWCSTR Default,    // Исходное значение (UTF16)
    int Width            // Ширина поля ввода
  );
  // Функция-псевдоним
  RDSXSTR RDSCALL rdsInputString( // Кодировка по умолчанию
    RDSXCSTR WinCaption, // Заголовок окна (кодировка по умолчанию)
    RDSXCSTR StrCaption, // Заголовок поля ввода (кодировка по умолчанию)
    RDSXCSTR Default,    // Исходное значение (кодировка по умолчанию)
    int Width            // Ширина поля ввода
  );

Тип указателя на эту функцию

RDS_SSSSI (для UTF8) или RDS_WsWsWsWsI (для UTF16)

Параметры

WinCaption (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку с заголовком окна или NULL, если заголовок должен быть пустым.
StrCaption (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку с заголовком поля ввода строки (текстом, отображаемым слева от поля ввода) или NULL, если этот заголовок должен быть пустым.
Default (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку с исходным значением поля ввода диалога или NULL, если на момент открытия окна поле ввода должно быть пустым.
Width (int): Ширина поля ввода в точках экрана.

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

Указатель на созданную в динамической памяти строку, содержащую введенный текст, если пользователь нажал кнопку «OK». Если пользователь нажал кнопку «отмена» или просто закрыл окно диалога, возвращается NULL.

Примечания

Эта функция используется в тех случаях, когда необходимо дать пользователю возможность ввести одну строку, при этом в заголовке окна и поля ввода можно разместить текст, поясняющий назначение вводимой строки. Для ввода нескольких значений или создания более сложных диалогов следует использовать вспомогательные объекты RDS, предназначенные для создания модальных окон.

Динамическая строка, созданная функцией rdsInputString, должна быть обязательно освобождена функцией rdsFree.

Пример

Пример использования функции приведен в §2.7.1 руководства программиста.

См. также

rdsFORMCreate, rdsFree.