DIR_DIALOG

DIR_DIALOG N,D

THE CURRENT DIRECTORY OF THE SYSTEM OBJECT NUMBER N BECOMES THE DIRECTORY D

  • Type: Command
  • Parameters: 2
  • Group: System Objects

ACTION

The command DIR_DIALOG N,D changes the current directory of the system object number N, which becomes the directory D.

The system object is of type: OPEN_DIALOG, SAVE_DIALOG, OPEN_DIALOG_PIC, SAVE_DIALOG_PIC.

D is the absolute or relative name of the directory.

If D is a relative name, D is supposed to be a sub-directory of the current directory.

The absolute name is the entire name, related to the root of the file system (ex: "c:\temp\files\" or "c:\temp\files").

The relative name is the name of the directory related to the current directory (ex: "files").

SYNTAX: DIR_DIALOG N,D

  • N = system object number (integer or real). Must be greater than 0 and less than or equal to the allowed maximum number of system objects.
  • D = absolute or relative name of the directory.

USE

  • The function DIR_DIALOG is used to change the current directory of a OPEN_DIALOG, SAVE_DIALOG, OPEN_DIALOG_PIC, SAVE_DIALOG_PIC.

ERROR

  • If number N is not a correct expression.
  • If number N exceeds the allowed maximum number of system objects.
  • If number N is less than 0.
  • If system object number N does not exist.
  • If system object number N is not of the type : OPEN_DIALOG, SAVE_DIALOG, OPEN_DIALOG_PIC, SAVE_DIALOG_PIC.
  • If D is not a correct name of directory.

EXAMPLE

rem create an Save_Dialog

save_dialog 1

rem take as current directory the directory "c:\aaaa"

dir_dialog 1,"c:\aaaa"

SEE ALSO

OPEN_DIALOG

SAVE_DIALOG

OPEN_DIALOG_PIC

SAVE_DIALOG_PIC

FILE_DIALOG

FILE_NAME$()

FILTER