@DATABASE InterfaceEditor.guide @Index INDEXNODE @$VER: IEditor.guide 2.31 (22.12.96) @AUTHOR "Simone Tellini" @(C) "Simone Tellini Software" @WIDTH 74 @NODE MAIN "Interface Editor User Manual" Interface Editor - User Manual @{" Disclaimer                 " link disclaimer}@{" Gadget Selection           " link selection} @{" Copyright                  " link copyright}@{" IEditor's Menus            " link menus} @{" Updates                    " link updates}@{" Gadget Tags                " link gadgetstags} @{" How to register            " link register}@{" Moving & Sizing gadgets   " link move} @{" Requirements               " link requirements}@{" The Generated Source       " link source} @{" Introduction               " link introduction}@{" THe ARexx interface " link arexx} @{" Starting IEditor           " link starting}@{" Notes                      " link notes} @{" Keyboard commands " link keyboard}@{" Credits                    " link credits} @{" The ToolBar " link toolbar}@{" A look to the future       " link future} @{" History " link History.txt/MAIN} @{" Search... " system "Run SearchGuide InterfaceEditor_ENG.guide"} @ENDNODE @NODE disclaimer "Disclaimer" THERE IS NO WARRANTY FOR THE SOFTWARE TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHERE OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE SOFTWARE AS PERMITTED BELOW, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. @ENDNODE @NODE copyright "Copyright and Distribution" Interface Editor © Copyright 1994-96 Simone Tellini Software Written using DICE C v2 by Simone Tellini Piazza Resistenza 2 42016 Guastalla RE Italia Fidonet: 2:332/502.18 (Simone Tellini) Internet: wiz@pragmanet.it User Manual © Copyright 1995-1996 Simone Tellini Software reqtools.library is © Copyright Nico François Interface Editor is (C) 1994-96 by Simone Tellini Software. This program is SHAREWARE: if you use it, you should send @{"me" link author} your registration fee; in that way you will become a registered user of IEditor, you'll receive the keyfile for the program and will be able to use IE without any limitations. Supporting shareware is very important, you like good programs at a very low price, don't you? ;-) This program may be freely distributed provided that all files are included in the distribution without any modifications. You may *NOT* charge more than Fred Fish does for a single library disk. This program may *not* be uploaded on BBS's that claim copyrights on the uploaded material. The key file of Interface Editor is strictly personal and is *NOT* distributable in any way, only a backup copy for the registered user is allowed. When you use this program to design GUI(s) for either a commercial or a shareware program I would appreciate a little note about this in the documentation of the program. I would appreciate also to @{"receive" link author} a copy of that program, or, at least, a demo! :-) Commercial distribution of Interface Editor and/or its relative files is *NOT* allowed without written permission from the author. This also means the distribution on cover disks, disk magazines etc. I'll be glad to give the permission to insert this program on disk magazines or cover disks if I receive a copy of it. Write @{"me" link author} for details. Only the output of IEditor is not subjected to these rules. @ENDNODE @NODE register "How to register" Well, to register to IE all you have to do is to fill in the "Orderform" you should have found in this archive, put it in a closed envelope and send @{"me" link author} it with your registration fee. These are the fees: ITALY LIT. 30.000 REST OF THE WORLD US $ 25 From Italy, you can send your fee by cash, checks or postal orders. From abroad, you can only send EuroChecks or cash. Anyway, the best payment method is to use checks. @ENDNODE @NODE updates "Updates" Once registered, you'll receive a special keyfile which will let you use any copy of IE without limitations. So, you can get updates of IE directly from the PD distribution networks. You can always find the latest version of IEditor on Aminet, in the 'dev/gui' directory. Every registered user who has got an E-Mail address will receive a message when a new version of IE is released. IEditor is also present on the World Wide Web. Its URL is the following: http://www.pragmanet.it/~tellini/main.html Currently this BBS supports IEditor: - BBS: The Drake SysOp: Paolo Masetti Tel: +39-522-838800 Fido node: 2:332/522 Message Area: IEDITOR.LOC File name: Area SUPPORT - IEditxxx.lha (e.g. IEdit229.lha) Magic File Name: IEDITOR If some other BBS could support IEditor, I'll be very glad: write @{"me" link author} for details. @ENDNODE @NODE introduction "Introduction" Interface Editor lets you save a huge amount of time when you have to design a GadTools User Interface for your programs. This program's the successor of Interface Editor v1.0, which was a little program with very little control on the aspect of the interface. Starting with version 2.0, I've tried to make IEditor a good user-friendly program; I've also improved the output that, in v1.0, was very bad! These are the main features of IEditor v2: A complete intuition/gadtools user interface Editing on many different screen resolutions Editing/Generating source on/for big autoscrolling screens All GadTools gadget kinds supported Full control over the window flags and tags Fully mouse and keyboard controlled Multiple windows User selectable font for every gadget The possibility to change screen resolution while editing Easy gadget alignment and dimensioning Multiple gadget moves, deletes, edits and copies. Boolean gadgets, Bevel Boxes, MENU_IMAGEs ARexx Port ARexx Interface Editor Expandible using external modules ... @ENDNODE @NODE requirements "Minimal configuration required" InterfaceEditor requires Kickstart 2.04+ and 512kb RAM at least. It's advisable to use at least a 8 kbytes stack for IE. These libraries are used by IEditor: reqtools.library v37+ icon.library v37+ locale.library v38+ (optional) asl.library v37+ gadtools.library v37+ intuition.library v37+ dos.library v37+ graphics.library v37+ diskfont.library v37+ iffparse.library v37+ rexxsyslib.library (optional) To compile the output of IEditor you need a C compiler (like DICE) or an assembler with 2.0 includes or the Amiga E compiler (EC) v2.1b or better. If you generate the Assembly sources with the RawCode @{"parameter" link asmprefs}, the include files won't be needed. InterfaceEditor has been tested on these machines: · Amiga 1200 68EC020 28MHz 2Mb CHIP 4Mb FAST Ram ( Blizzard 1220/4 ) HD IDE Conner 1.2 Gb Squirrel Classic CD-ROM SCSI Pioneer DR-U124X 2 Floppy Drives Kick v39.106 - WB v39.29 ( Release 3.0 ) · Amiga 4000/40 68040 25MHz 2Mb CHIP 16Mb FAST Ram HD IDE Conner 210 Mb HD IDE Seagate ST144At 124 Mb Kick v39.106 - WB v40.42 ( Release 3.0 ) · Amiga 2000B 68000 7MHz 1Mb CHIP 2Mb FAST Ram HD SCSI 850 Mb Kick v40.63 - WB v40.42 ( Release 3.1 ) @ENDNODE @NODE starting "Starting with Interface Editor" You can run Interface Editor from either the Shell or the Workbench. From Shell, it accepts as a argument the name of a previously saved GUI file. From WB, it accept as WB argument the icon of a previously saved GUI... ;) When it's loaded, you will see a screen with a little window: the @{"ToolBar" link toolbar}. Then you can load an old interface or start creating a new one. To load a GUI you can select the item @{"Open..." link "open"} in the first menu or you can click on the 10th gadget of the @{"ToolBar" link toolbar} and then select the file you want to load. To start creating a new interface, you must click on the first gadget of the @{"ToolWindow" link toolbar} or select the item @{"New..." link "new"} in the "Windows" menu. @ENDNODE @NODE making "Making a Gadget" Making a gadget is very simple. First of all you have to select the item "Add..." in the "Gadgets" menu or click on the 5th gadget of the @{"ToolBar" link toolbar}. Then you must choose the kind of the gadget in the listview which will appear. Now move the mouse pointer to where you want the top-left corner of the gadget to be (you'll see the coordinates on the ScreenBar). Click LMB (left mouse button) and move the mouse while olding down the button. You'll see a box which represents your gadget, whose dimensionsions are showed in the ScreenBar. Once you've decided the size of the gadget, release the mouse button. A requester will pop up: here you can edit the gadget title. After that another request will pop up letting you modify the gadget tags. Then, the gadget will be created. If the creation operation fails, you'll see a black rectangle intead of the gadget. Here's a list of the gadget supported by IE2: @{" BUTTON        " link "button"} @{" CHECKBOX      " link "checkbox"} @{" INTEGER       " link "integer"} @{" LISTVIEW      " link "listview"} @{" MX            " link "mx"} @{" NUMBER        " link "number"} @{" CYCLE         " link "cycle"} @{" PALETTE       " link "palette"} @{" SCROLLER      " link "scroller"} @{" SLIDER        " link "slider"} @{" STRING        " link "string"} @{" TEXT          " link "text"} @{" BOOLEAN       " link "boolean"} Note that the @{"CHECKBOX" link checkbox} and @{"MX" link mx} gadgets have a fixed size which means that you cannot make them any size you wish (unless you set the scaled tag of the gadget). Moreover, with placing these gadgets, there can be some problems if you use a font bigger than Topaz 8 and don't set the scaled tag. NOTE: the @{"BOOLEAN" link boolean} gadget type isn't handled by gadtools.library, but it's a simple intuition gadget. @ENDNODE @NODE selection "Gadget Selection" If the gadgets aren't disabled or detached, to select one of them you have to press LMB where there are no gadgets, then (holding down the mouse button) draw a rectangle so that the gadget(s) that you want to select is/are partly or completely covered by the box. If the gadgets are disabled or detached you can simply click on the gadget you like to select. You can always drag a box around more than one gadget, to do a multiple selection. Moreover, if you hold down the SHIFT @{"key" link keyboard}, the gadgets currently active won't be deactivated, but will remain active. When a gadget is activated, it will have a box around it with four dot in the corners. @ENDNODE @NODE move "Moving & Sizing Gadgets" It is possible to move or @{"resize" link size} one or more gadgets at the same time, depending on how many gadgets are @{"selected" link "selection"}. To move a gadget, simply click on it and move the mouse holding down the mouse button. (If you want to move more than a gadget at the same time, you'll have to keep a Shift @{"key" link keyboard} pressed) You'll see boxes representing your gadgets, when they're where you want, just release the mouse button. It wasn't so hard, was it? To @{"size" link size} a gadget you'll have to click in one of its four corners; then move the mouse while holding down the button. Release the mouse button to perform the changes. @ENDNODE @NODE size "Gadgets/Size..." You can choose to size a gadget (or more than one) by specifying its width and height or by sizing them with your @{"mouse" link move}. In the first case, select the item "Gadgets/Size...": a requester will pop up, enter here the values you want (also X and Y coordinates can be entered here). @ENDNODE @NODE copy "Gadgets/Copy" This will create a copy of the @{"selected" link "selection"} gadgets: after selecting this item, you will see boxes representing the selected gadgets that will follow the mouse pointer. When they're where you want them to be, press LMB. The new gadgets will be created in that place and will have ALL the attributes equal to the original gadgets, labels included. @ENDNODE @NODE menus "IEditor's Menus" Well, here you find the description of all the menus of my program: Project @{" About...         " link "about"} @{" New             " link "new"} @{" Open...          " link "open"} @{" Save             " link "save"} @{" Save As...        " link "saveas"} @{" Parameters... " link srcparams} @{" Generate Source... " link gensrc } @{" Exit...         " link "quit"} Windows @{" New...          " link "newwindow"} @{" Open...         " link "openwindow"} @{" Close           " link "closewindow"} @{" Close All       " link "closeallwindow"} @{" Discard         " link "discardwindow"} @{" Discard All     " link "discardallwindow"} @{" Title...        " link "titlewindow"} @{" Flags...        " link "windowflags"} @{" IDCMP...        " link "idcmp"} @{" Size...         " link "sizewindow"} @{" Zoom...         " link "zoomwindow"} @{" Tags...         " link "windowtags"} BevelBoxes @{" Add " link addbox} @{" Edit... " link editbox} Images @{" Add " link addimg} @{" Move " link moveimg} @{" Delete " link deleteimg} Texts @{" Add... " link addtxt} @{" Delete... " link deltxt} @{" Edit... " link edittxt} @{" Move... " link movetxt} Gadget Banks @{" Make... " link makegbank} @{" Delete... " link delgbank} @{" Show... " link showgbank} @{" Hide... " link hidegbank} @{" Parameters... " link editgbank} @{" Print " link printwnd} @{" Save...         " link savewindow} @{" Load...         " link loadwindow} Gadgets @{" Add...          " link "making"} @{" Remove          " link "delete"} @{" Select All      " link "selectall"} @{" Items...        " link "item"} @{" Size... " link size} @{" Tags            " link "tags"} @{" Font            " link "font"} Align @{" Right          " link "right"} @{" Left           " link "left"} @{" Top            " link "top"} @{" Bottom         " link "bottom"} Spread @{" Horizontally " link spreadhoriz} @{" Vertically " link spreadvert} Spacing @{" Set X... " link xspacing} @{" Set Y... " link yspacing} Clone @{" Width          " link "xsize"} @{" Height         " link "ysize"} @{" Both           " link "xysize"} @{" Copy            " link "copy"} @{" TabCycle order " link taborder} @{" Save...         " link "savegadgets"} @{" Load...         " link "loadgadgets"} Screen @{" Tags...          " link "screentags"} @{" Type...          " link "screentype"} @{" Font...          " link "getfont"} @{" DriPens...       " link "dripens"} Palette @{" Modify          " link "palettemodify"} @{" Load...         " link "paletteload"} @{" Save...         " link "palettesave"} @{" Save...          " link "savescr"} @{" Load...          " link "loadscr"} Misc @{" Menu Editor...   " link "menued"} @{" Image Bank...    " link "imgbank"} @{" ARexx Editor... " link arexxed} @{" main()... " link mained} @{" Localization... " link localize} Macros @{" Function keys... " link macros} @{" Add... " link addmacro} @{" Remove... " link remmacro} @{" Execute... " link execmacro} Preferences @{" Tools Window            " link "toolswindow"} @{" Use Gadgets             " link "usegads"} @{" Workbench...            " link "closewb"} @{" Current Window In Front " link "infront"} @{" Use WFlags              " link "usewflags"} @{" Asm Source...           " link "asmprefs"} @{" Generator...            " link genprefs} @{" Create icons            " link "createicons"} @{" Save                    " link "saveprefs"} @ENDNODE @NODE new "Project/New" This will remove from memory the current GUI, so that you can start creating a new one from scratch. If the GUI hasn't be saved, you will be asked if you want to continue or to abort the operation. @ENDNODE @NODE open "Project/Open..." This will present you with a filerequester in which you must select the GUI that you wish to load. When you have made changes to the GUI in memory that have not been saved yet you will be asked if you want: A) Yes - Delete the GUI in memory. B) No - Abort the operation. When the loading operation is finished you will be able to select a window to open with the menu @{"Windows/Open..." link "openwindow"} @ENDNODE @NODE save "Project/Save" This will save the GUI currently in memory to the name under which it was saved last time. If it's the first time you save it, a file requester will pop up asking for a file name. @ENDNODE @NODE saveas "Project/Save As..." This has the same function of "Project/Save...", but always opens the file requester. @ENDNODE @NODE gensrc "Project/Generate Source..." This will present you with a filerequester in which you must select the name which will be used to save the generated source. If you haven't chose a generator yet, its @{"configuration" link genprefs} window will pop up. Otherwise, IE will use the generator you've chosen before. Please refer to @{" The Generated Source " link "source"} chapter for more information. @ENDNODE @NODE closewb "Preferences/Workbench" This will try to close the Workbench (or open it if it was closed). If you close the WB and then exit from IEditor, the Workbench will be automatically opened again. @ENDNODE @NODE about "Project/About..." I think you know what it does, don't you? Well, it opens that window with copyright infos and my address that you should see every time you load Interface Editor (unless you are a registered user ;). @ENDNODE @NODE quit "Project/Exit" Selecting this item, you will leave IEditor. If the current GUI is not saved, IE will ask you if you want to "Save", save it in binary format, "Exit", quit immediatly or "Cancel", don't quit. @ENDNODE @NODE delete "Gadgets/Remove" Selecting this item, a requester will ask you if you really want to delete the @{"selected" link "selection"} gadget. Answering yes to it, will cause IEditor to delete them, for ever. You can delete the gadgets also by pressing the 'DEL' @{"key" link keyboard}. REMEMBER: Once a gadget is deleted, you cannot bring it back! @ENDNODE @NODE tags "Gadgets/Tags..." This will open a requester to edit the tags of the gadget(s) @{"selected" link "selection"}. For every gadtools gadget, you'll find these gadgets: Title: Insert here the gadget text. Label: This will identify the gadget in the source. Note that if you don't specify it, it will be created when the source is generated. Title Position: This lets you select where the gadget text should be placed. Underscore: Check it if you want an underlined letter in the gadget text. The letter to underline must be preceded by "_". Highlight Title: Check it if you want the title to be written with the Highlight Pen of the screen. With some gadgets kind, it has no effect. Other gadgets are present according to the kind of the gadget. Select the kind you want to know more about: @{" BUTTON        " link "button"} @{" CHECKBOX      " link "checkbox"} @{" INTEGER       " link "integer"} @{" LISTVIEW      " link "listview"} @{" MX            " link "mx"} @{" NUMBER        " link "number"} @{" CYCLE         " link "cycle"} @{" PALETTE       " link "palette"} @{" SCROLLER      " link "scroller"} @{" SLIDER        " link "slider"} @{" STRING        " link "string"} @{" TEXT          " link "text"} This gadget type is not handled by gadtools.library, so it hasn't got any tag, but maybe you want to know which parameters you can modify... ;) @{" BOOLEAN       " link "boolean"} @ENDNODE @NODE left "Gadgets/Align/Left" This asks you to click on the gadget that has the left-edge that you want to align to. When you click on the gadget all @{" selected " link "selection"} gadgets will inherit the left-edge coordinate of the clicked gadget. @ENDNODE @NODE right "Gadgets/Align/Right" This asks you to click on the gadget that has the right-edge that you want to align to. When you click on the gadget all @{" selected " link "selection"} gadgets will inherit the right-edge coordinate of the clicked gadget. NOTE: This might not always work when you align to the right-edge of a @{" PALETTE " link "palette"} gadget. The gadtools.library sizes this gadget so that it fits within the area specified which makes it possible that the gadget is actually smaller than specified. @ENDNODE @NODE top "Gadgets/Align/Top" This asks you to click on the gadget that has the top-edge that you want to align to. When you click on the gadget all @{" selected " link "selection"} gadgets will inherrit the top-edge coordinate of the clicked gadget. NOTE: This might not work when you try to align a @{" MX " link "mx"} gadget, if this gadget uses a font higher than 8 and doesn't have the scaled tag set to true. @ENDNODE @NODE bottom "Gadgets/Align/Bottom" This asks you to click on the gadget that has the bottom-edge that you want to align to. When you click on the gadget all @{" selected " link "selection"} gadgets will inherrit the bottom-edge coordinate of the clicked gadget. NOTE: This might not always work when you align to the bottom-edge of a @{" LISTVIEW " link "listview"} gadget. The gadtools.library sizes this gadget so that it fits within the area specified which makes it possible that the gadget is actually smaller than specified. NOTE 2: This might not work when you try to align a @{" MX " link "mx"} gadget, if this gadget uses a font higher than 8 and doesn't have the scaled tag set to true. @ENDNODE @NODE xsize "Gadgets/Clone/Width" This will ask you to click on the gadget that has the width that you want to clone. When you click on the desired gadget all @{" selected " link "selection"} gadgets will get the same width as the clicked gadget. @ENDNODE @NODE ysize "Gadgets/Clone/Height" This will ask you to click on the gadget that has the height that you want to clone. When you click on the desired gadget all @{" selected " link "selection"} gadgets will get the same height as the clicked gadget. @ENDNODE @NODE xysize "Gadgets/Clone/Both" This will ask you to click on the gadget that has the dimensions that you want to clone. When you click on the desired gadget all @{" selected " link "selection"} gadgets will get the same dimensions as the clicked gadget. @ENDNODE @NODE loadgadgets "Gadgets/Load..." This will open an ASL filerequester with which you can select a set of previously saved gadgets. Those gadgets will be placed in the active window and they don't replace the gadgets already existing in it. @ENDNODE @NODE savegadgets "Gadgets/Save..." This will save all @{" selected " link "selection"} gadgets. @ENDNODE @NODE item "Gadgets/Items..." This will open the Items Editor: it consists of a listview in which you can see the items that the @{"selected" link "selection"} gadget has, a string gadget which lets you modify the items and three buttons: New: Adds a new item to the list. Delete: Delete the selected item. Ok: (=ESC) Close the editor. This function works only with @{"LISTVIEW" link "listview"}, @{"MX" link "Heddley_Error"} and @{"CYCLE" link "cycle"} gadgets. For the last two ones, you are obliged to insert at least TWO items. @ENDNODE @NODE font "Gadgets/Font..." This will open an ASL Font Requester in which you can select a font. This font will be used for all the @{"selected" link "selection"} gadget. @ENDNODE @NODE selectall "Gadgets/Select all" Yeah! You guessed it! This will select all the gadgets of the current window. ;) @ENDNODE @NODE newwindow "Window/New..." This will open a new blank window. You can open as many window as you want (you must have enough memory, of course). @ENDNODE @NODE discardwindow "Window/Discard" The currently active window will be deleted from memory. BE CAREFUL! @ENDNODE @NODE discardallwindow "Window/Discard All" All windows will be deleted from memory. BE VERY CAREFUL! @ENDNODE @NODE openwindow "Window/Open..." A list of the currently in memory windows will appear: click on the one you want to open. You can use also the arrow @{"keys" link keyboard} to go up and down the list, the return key to select and the ESC key to abort. @ENDNODE @NODE loadwindow "Window/Load..." This will open an ASL filereq with which you can choose a window to load. The selected window will be appended to the other windows of the interface. @ENDNODE @NODE savewindow "Window/Save..." This opens a filereq in which you can select the name to save the active window to. @ENDNODE @NODE windowflags "Window/Flags..." This will pop up a list of the windows flags: you can choose the ones you wish by clicking on them. The selected ones will be marked by this '*'. Note that the flags aren't set, unless you have checked the menu item @{" Preferences/Use WFlags " link "usewflags"}. @ENDNODE @NODE idcmp "Window/IDCMP..." This will pop up a list of the windows IDCMP: you can choose the ones you wish by clicking on them. The selected ones will be marked by this '*'. NOTE: None of the IDCMP flags are actually used withing IEditor. The flags will only turn up in the generated source. @ENDNODE @NODE windowtags "Window/Tags..." This will open up a window in which you can edit the most important window tags. In the window you will find the following gadgets: ScreenTitle You can type an alternate screen title in here. This will be the title of the screen when the window is active. AutoAdjust When this gadget is checked intuition will automatically adjust the window position and dimensions to force it to fit on the screen. FallBack When your window is supposed to open on a specific screen and that screen is not available it will automatically open on the default public screen when this gadget is checked. MouseQueue This enables you to set the maximum # of MOUSEMOVE messages that will be pending at your message port at one time. RptQueue The same as MouseQueue only this time the maximum # of RAWKEY/VANILLAKEY messages can be set. Notify Depth If this tag is set to true, you will receive an IDCMP_CHANGEWINDOW when your window is depth-arranged. Menu Help If checked, enables the MenuHelp feature for this window. Tablet Messages It requests extended IntuiMessages for your window, so you can receive IESUBCLASS_NEWTABLET input events with IntuiMessages. Shared IDCMP Port If checked, this window will use the @{"shared IDCMP" link sharedport} port. In the Localize box, you'll find some checkboxs that will lets you decide what to localize in that window. @ENDNODE @NODE closewindow "Windows/Close" This will close the active window, letting you save the memory allocated for it and for its gadgets. If you want to open it again, select the item @{"Open..." link "openwindow"} from this menu. @ENDNODE @NODE closeallwindow "Windows/Close All" This will close all the windows of your GUI, letting you save the memory allocated for them and for their gadgets. If you want to open them again, select the item @{"Open..." link "openwindow"} from this menu. @ENDNODE @NODE titlewindow "Windows/Title..." This will open the window title requester, in which you can specify the window title (Noo! ;) and the label for the window. Note that if you don't specify a label, it will be created by IE when you generate your source. @ENDNODE @NODE sizewindow "Windows/Size..." This will open a requester in which you can specify all the size tags of the windows, that are: MinWidth, MinHeight, MaxWidth, MaxHeight: these determine the minimal and maximum dimensions of the window. Pressing the "*" gadget next to the integer gadgets, the actual dimension of the active window will be copied into them. Inner Width, Inner Height: if selected, these will determine the inner size of the window, no care of the size of the border or the title bar. The Ok and Cancel gadgets confirm or abort the operation respectively. @ENDNODE @NODE zoomwindow "Windows/Zoom..." This will open a requester in which you'll find these gadgets: Top: Y coordinate of the top left corner of the window when the zoom gadget is pressed. -1 indicates that the window must remain where is. (Kick 3.0) Left: X coordinate of the top left corner of the window when the zoom gadget is pressed. -1 indicates that the window must remain where is. (Kick 3.0) Width: It indicates the width that the window should have when the zoom gadget is pressed. Height: It indicates the height that the window should have when the zoom gadget is pressed. Ok: It confirms the changes. Cancel: It abort the operation. There are also four "*" gadget: pressing them the actual size and position of the window will be copied into the respective integer gadgets. @ENDNODE @NODE getfont "Screen/Font..." This will open the ASL Font Req in which you can select a new font for the screen. Note that this will affect the source code only if the generation of the screen has been @{"actived" link srcparams}. @ENDNODE @NODE dripens "Screen/DriPens..." This will open a requester in which you can edit the DriPens, that are an array of pen numbers which are used to create the OS 2.0 new look. In this req you will find these gadgets: Pens In this cycle gadget you can select the pen to edit. Currently the following pens are supported: DETAILPEN 1.3 compatible DetailPen. BLOCKPEN 1.3 compatible BlockPen. TEXTPEN Used for rendering gadget texts and the window titles. SHINEPEN Used to render the light-side of the gadget and window borders. SHADOWPEN Used to render the dark-side of the gadget and window borders. FILLPEN Used to render the background of a selected gadget and the window borders when it is active. FILLTEXTPEN Used to render the gadget texts of selected gadgets and window titles of active windows. BACKGROUNDPEN Used to render the background of un-selected gadgets. HIGHLIGHTTEXTPEN Used to render the texts of gadgets with the Highlight switch on. NOTE: The following three pens are only available under 3.0. BARDETAILPEN Used to render the text of the NewLook menus. BARBLOCKPEN Used to render the background of the NewLook menus. BARTRIMPEN Used to render the line below the menu bar. Palette With this gadget you can change the actual DriPen. OK Confirm the DriPens. Cancel Cancel the operation. @ENDNODE @NODE palettemodify "Screen/Palette/Modify..." This will open a standard ReqTools color requester, that will let you change the current palette of the screen. @ENDNODE @NODE paletteload "Screen/Palette/Load..." This will open an ASL file requester in which you can select an IFF-ILBM file. The palette of that file will be used for the screen. @ENDNODE @NODE palettesave "Screen/Palette/Save..." This will open an ASL file requester in which you can enter the name of the palette file. IEditor saves the color map in a standard IFF-ILBM file. @ENDNODE @NODE screentags "Screen/Tags..." In the Screen Tags editor you will find the following gadgets. Left, Top These specify the position of the top left corner of the screen. Title In this gadget you can type the title of the screen. This is the title which will be displayed when there are no windows active which have their own screen title. Show Title If it isn't checked, the screen will not have the title-bar. Behind Setting this, the screen will be opened behind the other ones. This lets you to prepare it before putting it on front. Quiet Tells Intuition not to render system screen gadgets or title. Type This gadget will allow you to change the screen type you are creating. The following types are supported: CUSTOMSCREEN The screen of your GUI cannot be used by other programs. PUBLICSCREEN The screen of your GUI can be used by any other program. Overscan If this is checked, in the generated source there won't be the definition of the screen size via SA_Width & SA_Height, but SA_Overscan will be used instead. Pub Name If you enter here a string, the screen will be a Public Screen, whose name is it. Full Palette If set, when the screen is opened, all its color map entries will be overridden by the set of preferences colors. Error Code If set, in the source will be generate a variable in which an extended error code will be put in the case that OpenScreenTagList fail. Draggable If not set, the screen won't be draggable with the title bar. This works only with kick v39+. Exclusive Set it if you never want your screen to share the display with another one. This means that the screen can't be pulled down and will not appear behind other screens that are pulled down. This works only with kick v39+. Share Pens If set, Intuition will obtain the pens for your screen in shared mode. This works only with kick v39+. Interleaved Requests Intuition to alloc an interleaved bitmap for your screen. This works only with kick v39+. Like Workbench Set it if you want a screen just like the Workbench one. This works only with kick v39+. MinimizeISG It tells Intuition to use the smallest Inter Screen Gap possible for your screen. This works only with kick v40+. @ENDNODE @NODE screentype "Screen/Type..." This will open the ASL screen mode requester. In the screen mode requester you can change all important stuff concerning the screen. THE VGA AND A2024 MODES MAY ONLY BE USED WITH VGA/MULTISYNC OR A2024 MONITORS! USAGE OF THESE DISPLAY MODES ON A STANDARD RGB MONITOR MAY RESULT IN SERIOUS DAMAGE TO THE MONITOR. @ENDNODE @NODE savescr "Screen/Save..." This will open an ASL File Requester in which you can enter the name of the file in which you want to save the current screen definition. @ENDNODE @NODE loadscr "Screen/Load..." This will open an ASL File Requester in which you can select a file to load the screen definition from. @ENDNODE @NODE localize "Misc/Localization..." This will open a requester in which you'll find these gadget: Catalog name  of   the   catalog   of   your   application (IE will append ".catalog") Join Insert here the path of a .cd file to join to  the one generated by IE. In that way, you  can  insert into the catalog more strings than the  ones  used by your GUI. The specified file will be prepended  to  the  new .cd file, so that you needn't  to  recompile  all your application when you add or remove  a  string from  the   GUI.  Of  course,  you  will  have  to recompile your GUI whenever you add  or  remove  a string from the .cd (and .ct) file generated. NOTE: as of version 2.31 you are encouraged not to use this field anymore, but to import the strings you need with the "Import..." gadget. Built In Insert here the default language of your program. Version Minimum catalog version required by your program. If 0, any version will be accepted. Activated This actives the localization of your GUI. Languages Here you can see  the  languages  which  IE  will create the locale files for. New Adds a new language. You should specify the  name of the language and the name of  the  translation file that will be created for that language. Note that the ".ct" suffix is automatically added by IEditor. Delete This will remove the selected  language  and  ALL the translation strings related to it. Strings Here you can  handle  all  the  strings  of  your application.   So   you   can  handle  the  whole localization process from inside IEditor. Double-clicking on a string brings up the  string requester explained below. New Adds a new string to the database. Delete Remove a string from  the  database.  You  cannot delete a strings used by the GUI, of course. Import... This will let you scan a .cd file and import  all the strings it contains into IEditor. These are the gadgets of the string requester: String The string you're editing. Note that here you can only modify the strings  not  used  by  the  GUI: changing a string used in the GUI won't have any result. ID Label for that string. You can then refer to that string using "CatCompArray[ ID ].cca_Str" in your code. The labels for the strings used in  the  GUI  are assigned by IEditor when generating the source. Translations Translations for the string. @ENDNODE @NODE gadgetstags "Gadget Tags" Select the kind you would like to know more about: @{" BUTTON    " link "button"} @{" CHECKBOX  " link "checkbox"} @{" INTEGER   " link "integer"} @{" LISTVIEW  " link "listview"} @{" MX        " link "mx"} @{" NUMBER    " link "number"} @{" CYCLE     " link "cycle"} @{" PALETTE   " link "palette"} @{" SCROLLER  " link "scroller"} @{" SLIDER    " link "slider"} @{" STRING    " link "string"} @{" TEXT      " link "text"} @{" BOOLEAN    " link "boolean"} @ENDNODE @NODE button "BUTTON" This are the tags you can specify with IE: Disabled When this option is on the created gadget will be created disabled. Immediate When this tag is set, the gadget will send you an IDCMP_GADGETDOWN message when it is pressed. This works only with kick v39+. @ENDNODE @NODE checkbox "CHECKBOX" This are the tags you can specify with IE: Disabled When this option is on the created gadget will be created disabled. Checked By default the created gadget is off. When you turn this option on the gadget will be created "checked". Scaled This tags works only with Kickstart 3.0+. If you set it, you will be able to change the size of the checkbox gadget. NOTE: if you use a font higher than 8 points, the gadget won't be placed where you draw it, but a little further down. Setting this tag, it will be placed exactly. @ENDNODE @NODE integer "INTEGER" This are the tags you can specify with IE: Disabled When this option is on the created gadget will be created disabled. Tab Cycle If this tag is set, when the user presses the TAB key while the gadget is active, the next gadget will be activated. Immediate When this tag is set, the gadget will send you an IDCMP_GADGETDOWN message when it is pressed. This works only with kick v39+. Exit Help When this gadget is checked and the user presses the HELP key while the created gadget is active your program will receive a special message at the the window port telling you about the quest for help. You can identify this special message when the Code field of the IntuiMessage is 0x5F. Replace Mode This kind of gadget is normally created in the insert mode. Setting this tag it will be created in the replace mode, that means that when the user presses a key, it will overwrite the character below the cursor. Number Normally the gadget is created with 0 as its initial value. Here you can enter the value that you want it to default to. MaxChars In this gadget you can set the maximum number of digits that can be entered in this gadget. Justification With this gadget you can set the place where the numbers should appear in the gadget. @ENDNODE @NODE listview "LISTVIEW" This are the tags you can specify with IE: Disabled When this option is on the created gadget will be created disabled. With this gadget, this tag works only with kick v39+. Read Only When you switch this on the created gadget will be "read only" which means that the names in the list cannot be selected. Show Selected With this option turned on the name you select will be shown in a little box below the actual gadget. NOTE: Under Kickstart 3.0 this has been changed! Under 3.0 the selected entry will be displayed with a different background color. Top Top item that should be visible in the listview. Make Visible Number of the item that should be forced within the visible area of the listivew by doing minimal scrolling. This tag overrides "Top" and works only with kick v39+. MultiSelect This will turn the listview into a multiselectable one. This feature works only with kick v39+. See  @{"this  section" link multiselectsrc}  to  know  how  to  use  these listviews. Scroll Width In this gadget you can enter the width of the @{" SCROLLER " link "scroller"} gadget in pixels. Max Pen The maximum pen number used by rendering in a custom rendering callback hook. This works only with kick v39+. Selected Number of the item that should be selected. Spacing In this gadget you can enter the number of pixels that is used as spacing between the list names. Item Height Enter here the exact height of an item. This is normally useful for listviews that use the GTLV_CallBack rendering hook. This works only with kick v39+. @ENDNODE @NODE mx "MX" This are the tags you can specify with IE: Disabled When this option is on the created gadget will be created disabled. With this gadget, this tag works only with kick v39+. Scaled This tags works only with Kickstart 3.0+. If you set it, you will be able to change the size of the mx gadget. NOTE: if you use a font higher than 8 points, the gadget won't be placed where you draw it, but a little further down. Setting this tag, it will be placed exactly. Title Place It indicates where the title should appear. Active This gadget enables you to set the option that is active when the gadget is created. Spacing In this gadget you can enter the number of pixels that is used as spacing between the options. @ENDNODE @NODE number "NUMBER" This are the tags you can specify with IE: Number By default the gadget displays 0. In here you can change the value that the created gadget will default to. Border When checked the created gadget will have a recessed border drawn around it. Front Pen The pen to use when rendering the number. -1 tells IE not to use this tag in the source. This works only with kick v39+. Back Pen The pen to use when rendering the background of the number. -1 tells IE not to use this tag in the source. This works only with kick v39+. Justification Determines where to render the number within the gadget box. This works only with kick v39+. Under v39, you must also set the tag Clipped, if you select this one, otherwise the text won't be printed. Format C-Style formatting string to apply on the number before display. Be sure to use the 'l' (long) modifier. This works only with kick v39+. Clipped If it's set, the text of the gadget will be clipped to gadgets dimensions. This works only with kick v39+. Max Number Len This indicates the maximum number of bytes that can be generated by applying the "Format" string. @ENDNODE @NODE cycle "CYCLE" This are the tags you can specify with IE: Disabled When this option is on the created gadget will be created disabled. Active This gadget enables you to set the option that is active when the gadget is created. @ENDNODE @NODE palette "PALETTE" This are the tags you can specify with IE: Disabled When this option is on the created gadget will be created disabled. Color In this gadget you can enter the color that is active in the created gadget. Depth The depth allows you to control the amount of colors that are displayed in the created gadget. 1 = 2 colors 2 = 4 colors ...... 8 = 256 colors NOTE: Currently only a value between 1 and 8 is allowed. Color Offset There may be times that you only want to have a portion of the available colors in the palette gadget. This gadget and the Depth gadget can make this happen. If you want to have the 2nd and 3rd color on a 4 color screen you do the following: Set Depth to 1 Set Offset to 1 This way you'll get the gadget you want. Indicator Width This tag indicates the desidered width of the current-color indicator. If it's equal to 0, the indicator won't be created. NOTE: This tag doesn't work with kick v39+. Indicator Height This tag indicates the desidered height of the current-color indicator. If it's equal to 0, the indicator won't be created. NOTE: This tag doesn't work with kick v39+. Num Colors Number of colors to display in the palette gadget. This overrides "Depth" and allows numbers which aren't powers of 2. This works only with kick v39+. @ENDNODE @NODE scroller "SCROLLER" This are the tags you can specify with IE: Disabled When this option is on the created gadget will be created disabled. Immediate When this option is on your window will receive a message at the moment the user clicks on the gadget. Rel Verify When checked your window will receive a message when the user releases the left mouse button while the pointer is still over the gadget. Top Enter the top position visible in the area the scroller represents in here. Total Enter the total number of positions that the scroller represents in here. Visible Enter the number of visible positions that the scroller represents in here. Arrows When checked the created scroller will have arrows to accompany it. In the gadget on the right you can adjust the size of the arrows. Freedom With this gadget you can set the direction in which the scroller is adjustable. @ENDNODE @NODE slider "SLIDER" This are the tags you can specify with IE: Disabled When this option is on the created gadget will be created disabled. RelVerify When checked your window will receive a message when the user releases the left mouse button while the pointer is still over the gadget. Immediate When this option is on your window will receive a message at the moment the user clicks on the gadget. Min Enter the minimum level of the slider in here. Max Enter the maximum level of the slider in here. Level By default the position of the slider is 0. In here you can enter the level that the slider will have when it is created. Max Level Len Maximum length in characters of level string when rendered beside the slider. This works only with kick v39+. Level Format In here you can enter a C-style formatting string for the level indicator. When you keep this empty there will not be a level indicator. Level Place With this gadget you determine the position at which the level indicator is rendered. Max Pixel Len It indicates the maximum pixel size used up by the level display for any value of the slider. This is useful when dealing with proportional fonts. This works only with kick v39+. Justification Determins how the level display is to be justified within its allotted space. This works only with kick v39+. Freedom With this gadget you can set the direction in which the slider is adjustable. @ENDNODE @NODE string "STRING" This are the tags you can specify with IE: Disabled When this option is on the created gadget will be created disabled. Immediate When this tag is set, the gadget will send you an IDCMP_GADGETDOWN message when it is pressed. This works only with kick v39+. Tab Cycle If this tag is set, when the user presses the TAB key while the gadget is active, the next gadget will be activated. ExitHelp When this gadget is checked and the user presses the HELP key while the created gadget is active your program will receive a special message at the the window port telling you about the quest for help. You can identify this special message when the Code field of the IntuiMessage is 0x5F. Replace Mode This kind of gadget is normally created in the insert mode. Setting this tag it will be created in the replace mode, that means that when the user presses a key, it will overwrite the character below the cursor. String Normally the gadget is created without a string in it. Here you can enter a string that will be the contents of the created gadget. Max Chars In this gadget you can set the maximum number of characters that can be entered in this gadget. Justification With this gadget you can set the place where the characters should appear in the gadget. @ENDNODE @NODE text "TEXT" This are the tags you can specify with IE: CopyText When checked GadTools will copy the text to an internal buffer so that the program can use it again. Border When checked the created gadget will have a recessed border drawn arround it. Clipped If it's set, the text of the gadget will be clipped to gadgets dimensions. This works only with kick v39+. Text By default the gadget displays nothing. In here you can type in a text that will be displayed when the gadget is created. Front Pen The pen to use when rendering the text. -1 tells IE not to use this tag in the source. This works only with kick v39+. Back Pen The pen to use when rendering the background of the text. -1 tells IE not to use this tag in the source. This works only with kick v39+. Justification Determines where to render the text within the gadget box. This works only with kick v39+. Under v39, you must also set the tag Clipped, if you select this one, otherwise the text won't be printed. @ENDNODE @NODE macros "Macros/Function keys..." This will open a little window in which you'll find 10 string gadgets and a cycle gadget. The string gadgets are named F1...F10: you can enter there the name of the ARexx script that you wish to associate to the respective function key. You can click on the "get file" gadget next to each string gadget to open a file requester. With the cycle gadget you can specify if the script is linked only to the function key, or to the fkey with a qualifier (None, SHIFT, ALT): thus you can use up to 30 script. @{"Scripts shipped with IEditor" link scripts} @ENDNODE @NODE addmacro "Macros/Add..." Besides linking ARexx scripts to the @{"function keys" link macros}, you can add items to the Macros menu. Selecting this item, a file requester will pop up with which you can select a script to add to the menu. Once added, a script can be executed just be choosing its name from this menu. @{"Scripts shipped with IEditor" link scripts} @ENDNODE @NODE remmacro "Macros/Remove..." Selecting this item, a window will pop up in which you'll see the list of the macros you've @{"added" link addmacro} to the menu. Clicking on the one you wish, you'll remove it. @ENDNODE @NODE execmacro "Macros/Execute..." This item will let you execute an ARexx script for IE. In fact a file requester will pop up: choose the script you wish to execute and it will be run. @{"Scripts shipped with IEditor" link scripts} @ENDNODE @NODE scripts "ARexx scripts shipped with IEditor" These are the scripts you'll find in IEditor's ditribution: ShadowText.ie ------------- Adds nice shadows to IntuiTexts. Save&Exit.ie ------------ Saves the GUI and quits IEditor. Shell.ie -------- Opens a Shell on IEditor's screen. ImgBox.ie --------- Adds a bevel box around an image. CenterText.ie ------------- Puts an IntuiText in the middle of the upper side of a BevelBox. Ridge20.ie ---------- Transform a bevel box in a ridge box compatible with OS 2.0 (ridge boxes created with the tag GTBB_FrameType need kickstart 3.0+) MoveImage.ie ------------ Moves an image to the specified coordinates. AlignBoxRight.ie AlignBoxLeft.ie AlignBoxTop.ie AlignBoxBottom.ie ----------------- Make alignement between bevel boxes. @ENDNODE @NODE toolswindow "Preferences/Tools Window" This will open/close the Tools Window. @ENDNODE @NODE usegads "Preferences/Use Gadgets" If not checked, the gadgets in the edit windows will be created and then detached. @ENDNODE @NODE infront "Preferences/Current window in front of" Select this to have the selected window always in front of the others. @ENDNODE @NODE usewflags "Preferences/Use WFlags" If checked, the windows that you're editing will use the flags you've set for them, otherwise my ;) flags are used. @ENDNODE @NODE genprefs "Preferences/Generator..." This will open a requester in which you can choose/configure the source generator. In this window you'll find a listview in which the installed generators are shown: you can activate the one you need just by clicking over it. Pressing on the "Config" gadget, the generator configuration window will pop up. As to the generators shipped with IE, here you can find the description of their parameter, for other generators please refer to their documentation: @{" C.generator " link cprefs} @ENDNODE @NODE asmprefs "Preferences/Asm Sources..." This will open a requester in which you can edit some parameters for the Asm Source: Data Section If checked, a DATA section will be created. BSS Section Try to guess... ;-) IntuiMsg If checked spaces for the IntuiMsg for the window will be created in the source. E.g. If you have a window whose label is "Win", you will find this in the source: WinMsg ds.b im_SIZEOF Clicked Ptr If checked, each gadget that generates an IDCMP event will have a pointer called Clicked in its UserData field. So, when you receive an IDCMP msg from your window, you should execute the routine pointed by this ptr. IDCMP Handler This will active the generation of the IDCMP @{"event handler" link handler}. Key Handler This will active the generation of the @{"Key Handlers" link keyhandler}. Gadget Labels If checked, each gadget will have its own pointer instead of a global array. Raw Code If checked, you will be able to assemble the code generated without the include files. Intuition Base Enter here the name you usually use in your sources to identify the Intuition Base GadTools Base You know it, don't you? ;) @ENDNODE @NODE cprefs "Preferences/C Sources..." This will open a requester in which you can edit some parameters for the C Source: IntuiMessage If set, in the source structures called Msg will be created. Clicked Ptr If set, in the source a pointer called Clicked will be put in the userdata field of each NewGadget. In this way, you can write an IDCMP Handler that, when it receives a message, executes the routine whose address is pointed by gg_UserData. Of course, in your source you must have routines called Clicked( void). IDCMP Handler This will active the generation of the IDCMP @{"event handler" link handler}. Key Handler This will active the generation of the @{"Key Handlers" link keyhandler}. To Lower If  checked,   the   @{"Key   Handler" link keyhandler}  will  be case-insensitive. Template If checked, IE will generate a file called _temp.c in which you'll find empty templates for the functions called by the GUI source. Smart Str If  checked,  the  generator  won't  write  a string twice. Use CatComp If checked, the generator will use CatComp to generate  the .ct  and  the strings files (CatComp should be in the path). Otherwise, the generator  will  create  those files by itself. NOTE: in the  strings  file  created  by  the generator there are just the  CATCOMP_NUMBERS and CATCOMP_ARRAY data. UWORD chip Enter here the syntax used by your compiler to put some data in a CHIP hunk. Headers You can enter here the name of a  file  where the include files to be used are defined. This will override the default includes  used by the C.generator. The 'R' gadget next to this one will  open  a file requester to select the file. This is an  @{"example" link headersexample}  of  headers  definition file. Use Use the prefs. Save Sabe & use the prefs. Cancel Cancel the changes. @ENDNODE @NODE saveprefs "Preferences/Save" This will save the current prefs setting. @ENDNODE @NODE headersexample "Example of a headers definition file" ##STANDARD #include #include #include #include #include #include #include #include #include #ifdef PRAGMAS #include #include #include #include #endif #include #include ##DISKFONT #include ##AREXX #include #include #include #include #include #include #include #include #include #ifdef PRAGMAS #include #include #endif ##LOCALE #include #include #ifdef PRAGMAS #include #endif ##end @ENDNODE @NODE fontadaptive "Font Adaptivity" IEditor is able to create GUIs which will automatically adapt their size to the font used in the screen they'll use: that means that the position and the size of all the gadgets, bevel-boxes, images, etc... will be fitted according to the font size. The source will also adapt the size and position of windows. Moreover it'll check if the window will fit in the screen: if it doesn't, the font "topaz 8" will be used. IE allows you to use any font when designing a font-adaptive GUI, but I'll recommend you not to use a font too large, otherwise there could be some problems adapting the gadgets. NOTE WELL: be careful when using fixed size gadgets such as @{"MX" link mx}, @{"CHECKBOX" link checkbox}, @{"BOOLEAN" link boolean} and @{"images" link imgbank}: their size won't be modified in order to be adapted to the font! @ENDNODE @NODE handler "The IDCMP Handler" The IDCMP Handler is a little routine which /handles/ all the message that arrive at your window user port: it creates a copy of the IntuiMessage, then it calls the appropriate routine. The name of the routine called are composed in this way: Example: If an IDCMP_CLOSEWINDOW message arrive at your "Main" window, the IDCMP handler will call the routine MainCloseWindow. There are two exceptions: IDCMP_GADGETUP/DOWN and IDCMP_MENUPICK: in these cases the IDCMP Handler will call the routine pointed by the UserData field of the gadget/menu. Moreover IDCMP_REFRESHWINDOW messages are completely handled by the handler. In the assembly language, the routines called will found a pointer to the copy of the IntuiMessage in A5. See the "GMExample" source code for a real-life example. @ENDNODE @NODE keyhandler "The Gadget Activation Key Handler" The Activation Key Handler is a little routine which handles the IDCMP VanillaKey messages that refer to a gadget activation key... So you can set your underscores without being bothered of how to handle them! The routine behaves like that: - with @{"INTEGER" link integer} and @{"STRING" link string} kinds, it performs an ActivateGadget() - with other gadget kinds, it invokes the KeyPressed() routine. NOTE: if you set the IDCMP_VANILLAKEY flag for your window, and you use the @{"IDCMP Handler" link handler}, if the key handler doesn't recognize the activation key, the routine VanillaKey will be invoked, so you can process other keys than the gadgets's ones. @ENDNODE @NODE source "The Generated Source" For the Asm and C languages, IEditor creates two source files. The first (.c|.s) will contain all the routines and data needed to set up the GUI. The second (.h|.i) will contain the Externs or XREFs and the constants for the gadgets ID. NOTE: if you generate the Amiga E source, remember that all your labels will have the first letter converted in lowercase! In the main file the following routines are generated: ========================================================================== int SetupScreen( void ); ========================================================================== This routine will open or lock the screen and get its visual info. This routine can return one of the following errors: 0 = No error. 1 = Could not open or lock the screen. 2 = Could not get the screen visual info. ========================================================================== void CloseDownScreen( void ); ========================================================================== This routine will free the resources taken by "SetupScreen()". You must still call this routine when "SetupScreen()" failed to close and free the resources that didn't fail to open!!! ========================================================================== int OpenWindow( void ); ========================================================================== There are as much of these routines as there are Windows in your GUI. These routines will set-up the gadgets and open the window. These routines can return one of the following errors: 0 = No error. 1 = Could not create a gadget context. 2 = Error during the gadgets creation. 3 = Could not create menus. 4 = Could not open the window. ========================================================================== void CloseWindow( void ); ========================================================================== There are as much of these routines as there are Windows in your GUI. These routines will free all resources that the "OpenWindow()" routine has taken. You must still call this routine if "OpenWindow()" has failed! The main file also has the following globals defined which are shared by all project windows: struct Screen *Scr; A pointer to the opened/locked screen APTR VisualInfo; A pointer to the visual info The following globals are only generated when the file contains gadgets or when the window must have a zoom gadget or when you've selected a font for a gadget: struct Gadget *GList; The created gadgets WORD Zoom[4]; The window alternate positions struct TextFont *_; Are also generated pointers for each project window that is in memory: struct Window *Wnd; Moreover, when the screen is generated and the tag Error Code is set, this ULONG will be included in the source: ULONG ErrorCode = NULL; Here you will find an error code which will tell you what's gone wrong while opening the screen. Last but not least, in the source a variable called YOffset will be generated: its value it's equal to Scr->WBorTop + Scr->Font->YSize. If you modify the screen font, you * MUST * update this variable! In the same way, you've got to keep up-to-date the XOffset variable, equal to Scr->WBorLeft. If some images are present in your GUI, IE will create these structures: struct Image Img = ... and if you put some images in the windows, structures like this will be created: struct Image _Image = ... When you've not set the item "Generate" in the screen menu, this pointer is generated: UBYTE *PubScreenName = NULL; This will allow you to change the name of the public screen to open on with out having to hack in the generated source. Also the main file contains the Gadget Array's for each project window which are define as follows: struct Gadget *Gadgets[]; To access the pointers in this array the program generates DEFINES or EQU'S in the header file which specify the position of a certain gadget in the array. These defines are build as follows: #define GD_ If @{"requested" link srcparams}, IE will generate the following routines: ========================================================================== BOOL OpenDiskFonts( void ); ========================================================================== Opens all the diskfonts used in the GUI. Returns FALSE (in asm, d0 = 0) if it couldn't open a font. Anyway, you *MUST* always call CloseDiskFont before your program exits! The pointers to the TextFont structures will be called: Font where is composed of: _