Приложения

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

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

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

А.5.5.2. rdsCallDirDialog – вызов диалога выбора папки

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

  RDSSTR RDSCALL rdsCallDirDialogA( // UTF8
    RDSCSTR InitialDir,  // Исходная папка (UTF8)
    RDSCSTR Title,       // Заголовок диалога (UTF8)
    BOOL AbsPath         // Вернуть абсолютный путь
  );
  RDSWSTR RDSCALL rdsCallDirDialogW( // UTF16
    RDSWCSTR InitialDir, // Исходная папка (UTF16)
    RDSWCSTR Title,      // Заголовок диалога (UTF16)
    BOOL AbsPath         // Вернуть абсолютный путь
  );
  // Функция-псевдоним
  RDSXSTR RDSCALL rdsCallDirDialog( // Кодировка по умолчанию
    RDSXCSTR InitialDir, // Исходная папка (кодировка по умолчанию)
    RDSXCSTR Title,      // Заголовок диалога (кодировка по умолчанию)
    BOOL AbsPath         // Вернуть абсолютный путь
  );

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

RDS_SSSB (для UTF8) или RDS_WsWsWsB (для UTF16)

Параметры

InitialDir (RDSCSTR, RDSWCSTR, RDSXCSTR)

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

Title (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку с заголовком окна диалога. Если в этом параметре передано значение NULL, диалог будет иметь заголовок «Папка».

AbsPath (BOOL)

TRUE, если функция должна вернуть полный путь к выбранной пользователем папке, и FALSE, если в возвращаемой строке необходимо заменить стандартные пути RDS на их символические обозначения.

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

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

Примечания

Эта функция используется в тех случаях, когда нужно запросить у пользователя имя какой-либо папки на диске (например, в настройках модуля автокомпиляции может потребоваться указание пути к папке стандартных библиотек). Если требуется путь к конкретному файлу, а не к папке, следует использовать функцию rdsCallFileDialog.

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

См. также

rdsCallFileDialog, rdsFree.