4 * [Generated from template, 25 September 1996]
7 #if !defined(__CC_NORCROFT) || !defined(__arm)
8 #error You must use the Norcroft ARM Compiler for Sapphire programs
11 #pragma include_only_once
12 #pragma force_top_level
21 /*----- Overview ----------------------------------------------------------*
33 /* --- template_find --- *
35 * On entry: R0 == pointer to name to match
37 * On exit: R0 == pointer to window definition if found
40 * Use: Locates a template in the list and gives you a pointer to
41 * the corresponding window defintion. You may update the
42 * definition to store an updated window state if you really
46 extern routine template_find;
48 /* --- template_copy --- *
50 * On entry: R0 == pointer to name to match
52 * On exit: R0 == pointer to copy of a window definition
55 * Use: Returns a copy of a window template (for the use of the
56 * dialogue box system mainly), including all indirected data
57 * set up properly and everything. The copy is writable. To
58 * get rid of the copy, call template_free.
61 extern routine template_copy;
63 /* --- template_embedded --- *
65 * On entry: R0 == pointer to embedded template definition
67 * On exit: R0 == pointer to copy (as for template_copy)
69 * Use: Extracts an embedded template into a template block.
70 * Embedded templates can be generated using the templAOF
71 * program, and then linked into your application.
74 extern routine template_embedded;
76 /* --- template_free --- *
78 * On entry: R0 == pointer to block allocated with template_copy
82 * Use: Frees a template copy created using template_copy.
85 extern routine template_free;
87 /* --- template_load --- *
89 * On entry: R0 == pointer to name of template file to load
91 * On exit: May return an error
93 * Use: Loads the specified template file, and adds its window
94 * definitions into the template list so they can be used when
95 * creating dialogue boxes or windows.
97 * If the templates can't be loaded (e.g. there isn't enough
98 * memory) an error is generated (and can be caught using the
99 * standard Sapphire except mechanism).
102 extern routine template_load;
104 /* --- template_init --- *
106 * On entry: R0 == pointer to application name
110 * Use: Initialises the template list and font array, and loads the
111 * `Templates' resource file.
114 extern routine template_init;
116 /*----- That's all, folks -------------------------------------------------*/