# (load_dialog filename)
[GstarCAD 2012](../../../Index.md) → [Developer Reference](../../%28Developer%20Reference%29.md) → [AutoLISP Reference](../%28AutoLISP%20Reference%29.md) → [LISP Functions](%28LISP%20Functions%29.md)
<!-- help-structure:notice -->
> **Source status:** This source topic has 1 recorded inherited issue(s). [Source issue details](../../../Source%20Issues.md).
<!-- /help-structure:notice -->
<a id="214"></a>
## (load\_dialog filename)
---
Load that dialog box definition file.
---
This function loads a [DCL](../../../Source%20Issues.md#issue-ec8611ed748fcdea) dialog control file. DCL files must be loaded before a custom dialog box can be displayed by GstarCAD®. The *filename* argument is the name of the DCL file.
This function returns the following codes:
| Return Code | Meaning |
| --- | --- |
| 1 | DCL was successfully loaded. |
| -1 | DCL file was not found. |
### Examples
| Code | Returns |
| --- | --- |
| (**load\_dialog** "basicdcl") | 1 |
| (**load\_dialog** "junkdcl") | -1 |
**NOTE** The order of calling a dialog box is as follows:
1. load\_dialog
2. [new\_dialog](%28new_dialog%20dialog%20dcl-id%20-function%20point-%29.md)
3. [action\_tile](%28action_tile%20key%20expression%29.md), [start\_image](%28start_image%20key%29.md), [start\_list](%28start_list%20key%20-operation%20-index-%29.md), etc (perform all dialog box initialization, such as associating an action with a tiles, creating an image, and making the lists for list boxes)
4. [start\_dialog](%28start_dialog%29.md)
**Tell me about...**
[(unload\_dialog dcl\_id)](%28unload_dialog%20dcl_id%29.md)
[LISP Compatibility](../LISP%20Compatibility.md)
[Programming Overview of LISP (LISt Processing) Language](../Programming%20Overview%20of%20LISP%20%28LISt%20Processing%29%20Language.md)
<a id="holding"></a>
## Other versions with matching text
[GstarCAD 2011](../../../../2011/Developer%20Reference/AutoLISP%20Reference/LISP%20Functions/%28load_dialog%20filename%29.md)