2.88 .directory

This attribute contains the path of the initial directory for the file or directory selection (filereq), when opening it via the built-in function querybox().

When the attribute has the value "" or an invalid path name, then the working directory of the application appears as the initial directory when called via querybox().

Definition

  • Data type

    string

  • Access

    get, set

  • changed event

    no

  • C

    Identifier: AT_directory

    Data type: DT_string

  • COBOL

    Identifier: AT-directory

    Data type: DT-string

  • Classification

    object-specific attribute

  • Objects

    filereq

Please note that the path indication must correspond to the notation of the system. For Microsoft Windows this is <drive>:\<dir 1>\…\<dir n> and for Unix /<dir 1>/…/<dir n>. Be aware that \ within strings must be written \\ in IDM files.

With a set .changedir attribute, and after a successful selection, this attribute contains the directory in which a file or directory was selected.

Particularities of Microsoft Windows

If the attribute .style is set to fr_directoryon the filereq object, the .directory attribute defines the topmost path. However, the attribute .directory limits the selection with .style = fr_directory only if the attribute .changedir has the value false. Otherwise (.changedir = true) the directory selection is unlimited and the directory specified in the .directory attribute is preselected.

The attribute value "" is interpreted as workplace and not as working directory.

See also

Attribute .changedir

Built-in function querybox()