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

Описания RDS

Приложения

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

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

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

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

# Приложения

## Приложение А. Функции, константы и структуры 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.