═══ 1. Special Notices ═══ Copyright (C) Allen Creek Software, Inc. 1991. All rights reserved. Allen Creek Software, Inc. 1209 W. Huron Ann Arbor, Michigan 48103 Phone: (313) 665-6530 Compuserve ID: 73577,2005 Next ═══ 2. How to Use this Document ═══ Next Previous (The following instructions are slightly modified from the OS/2 online Command Reference.) The EXE Tool Online Reference describes the purpose and usage of EXE Tool. Before you begin to use this reference, it would be helpful to understand how you can: o Expand the Contents to see all available topics o Obtain additional information for a highlighted word or phrase o Use action bar choices o Use Next and Previous to navigate the Online Reference How to Use the Contents When the Contents window first appears, some topics have a plus (+) sign beside them. The plus sign indicates that additional topics are available. To expand the Contents if you are using a mouse, click on the plus sign. If you are using the keyboard, use the Up or Down Arrow key to highlight the topic, and press the plus (+) key. For example, Dialogs has a plus sign beside it. To see the complete list of EXE Tool dialogs, click on the plus sign or highlight that topic and press the plus (+) key. To view a topic, double-click on the topic (or press the Up or Down Arrow key to highlight the topic, and then press the Enter key). How to Obtain Additional Information After you select a topic, the information for that topic appears in a window. You will notice that certain words in the text may be specially highlighted (The default color for this special highlighting is green). These words are links to additional information. If you are using a mouse, double-click on the highlighted word. If you are using a keyboard, press the Tab key to move to the highlighted word, and then press the Enter key. Additional information will appear in a pop-up window. How to Use Action Bar Choices A number of choices are available for managing information presented in the EXE Tool online reference. If you want to see more information about these choices, click on the name of the choice (or press the Tab key to move to the choice and press Enter). Bookmark Allows you to set a placeholder so you can retrieve information of interest to you. (This choice is available from the Services pull-down). Search Allows you to find occurrences of a word or phrase in the current topic, selected topics, or all topics. (This choice is available from the Services pull-down). Print Allows you to print one or more topics. (This choice is available from the Services pull-down). Copy Allows you to copy a topic you are viewing to a file you can edit. (This choice is available from the Services pull-down). Options Allows you to change the way your Contents is displayed. How to Navigate within the Online Reference This reference is designed so that you can go to a particular part of the reference quickly, via the table of contents, or you can read the reference 'cover to cover' through the use of the Next and Previous links. Next and Previous links will always appear at the top of a page. On pages containing large amounts of information, the links will also appear at the end of the information. Every page of this reference will have a Next and/or Previous hypertext link available. The Next link takes you to the next logical page and the Previous takes you to the previous logical page. The Previous link may result in some confusion under certain circumstances. For example, if you are reading a section and click on a link to another location in the reference, the Previous link that appears on the new page will not take you back to the last page you were looking at. Instead, it will take you to the page which logically preceeds the page you are currently looking at. This reference is organized by the windows which are created by EXE Tool. For each window, there is a description of what the window is displaying and how to manipulate it. Additionally there is page listing the items which appear on the menu bar. To speed the reading of the reference in 'cover to cover' fashion, the Next button does not descend into the description of menu bar items. Rather, it will bypass the menu item descriptions and continue with the next logical page. If you select the first menu item, the Next and Previous links function in a normal manner. Next Previous ═══ 3. Introduction ═══ Next Previous EXE Tool is a PM application that lets you view and manipulate information contained in EXE, DLL and RES files. EXE Tool will work with any file which is in 'old' or 'new' EXE format but is most useful for OS/2 Presentation Manager applications and DLL libraries. A good description of the 'old' and 'new' EXE formats can be found in Advanced OS/2 Programming by Ray Duncan. With EXE Tool you can: o Display both old and new EXE header information. o Modify EXE/DLL header information: - Name - Description - Application Type - Stack Size - Heap Size - Long File Name Support o Display internal EXE/DLL tables: - Segment Table - Resource Table - Imported Names Table - Resident Names Table - Non-Resident Names Table o Display and modify the Resource Table. o Display and modify .RES files. o Display resource definitions: - Accelerator Table - Bitmap/Pointer/Icon - Dialog - Dialog Include (DLGINCLUDE) - Menu - String Table - Other EXE Tool is invoked by issuing the following command: EXETOOL [] or EXETOOL -r [] If multiple filenames are entered on the command, each file will be displayed in a separate window. Wildcards are not currently supported. When the -r option is used, a Resource File Viewer is launched instead of the EXE/DLL viewer. This option is useful if you only want to manipulate .RES files and not .EXE or .DLL files. Usage Notes Right Button Scrolling In windows that have horizontal or vertical scroll bars, the contents of the window may be scrolled either horizontally or vertically by pressing and holding down the right mouse button and dragging the mouse outside the window. For example, to scroll the information in the window from right to left, click and hold the right mouse button while in the window and then drag the mouse outside the right side of the window frame. The text should scroll. Releasing the button or moving the mouse pointer back inside the window will stop the scrolling. This method can be used to scroll in any direction. Popup Menus Some windows have 'popup' menus defined which make it easier to perform common operations. Clicking and releasing the right mouse button will cause a popup menu to appear in any window that has a popup defined. Clicking on an item inside the menu using the left mouse button will cause that menu action to be executed and the popup menu to disappear. Clicking outside the menu with the left mouse button will make the menu disappear but no action will be taken. Environment Variables When an EXE or DLL file is saved after changes have been made, EXE Tool will write the data to a temporary file before replacing the original. The temporary file will be created in the current directory unless a TMP or TEMP environment variable is defined. If TMP or TEMP is defined, it should indicate a directory on a disk with sufficient disk space to hold a copy of the EXE or DLL file being saved. Next Previous ═══ 4. Main Window ═══ Next Previous Figure 1 shows an example of the main window. The screen is divided into a display area and a button area. Figure 1. EXE Tool Main Window The display area will show either the 'new' exe header information or the 'old' exe header information. If the file is in the 'new' format, the display will default to showing the 'new' header information. If the file is in the 'old' format, the 'old' header information will be shown. The currently displayed header can be changed via the 'Options/Header' menu. The button area contains buttons which cause new windows to be opened which display table information indicated by the button. Only one occurrence of each table will be displayed. If a table is already displayed, pressing the button will cause the window containing the table to be brought to the front and made the active window. Buttons can be activated either by using the mouse or using the accelerator key indicated in the button name. The underscored letter indicates an 'alt' key combination used to select the button. It will often be the case that one or more of the buttons will be disabled. This means that the table associated with that button does not exist. The one exception to this is the Resource Table. Since you are allowed to modify the Resource Table, the Resource Table button will always be active for 'new' format files. Files that are in 'old' format will have all buttons disabled. Next Previous ═══ 4.1. EXE Tool Menu ═══ Next Previous The following items appear on the EXE Tool main menu: File Toolbox Options ═══ 4.1.1. File ═══ Next Previous The following items appear on the File menu: New Window New Open... Open .RES File... Edit EXE Properties... Report... Save Save As... Exit ═══ New Window ═══ Next Previous Selecting this menu item causes a new main window to be displayed. The contents of the window will appear the same as if you had entered EXETOOL from the command line without specifying a file. ═══ New ═══ Next Previous Selecting this menu item causes the current window to be set to an 'empty' DLL definition. This allows you to create a new DLL and incrementally add resources and modify properties. If there are any changes to the currently viewed file, you will be given an opportunity to save them, discard them or cancel the New command. When the command finishes the file name in the title bar will be . If you make changes to this file you can save them by using the Save As... command. ═══ Open... ═══ Next Previous Selecting this menu item causes the Open File dialog to appear. This dialog lets you select or enter a file name that you want to view. If the file you choose is not a valid EXE or DLL file, you will be notified. If there are any changes to the currently viewed file, you will be given an opportunity to save them, discard them, or cancel the Open command. ═══ Open .RES File... ═══ Next Previous Selecting this menu item will let you open a new window used to view the contents of a resource file (.RES). The Open File dialog will be displayed which allows you to enter the name of the resource file you wish to view. The file must exist. If a valid name is given, the resource file viewer will be opened on the given file. ═══ Edit EXE Properties... ═══ Next Previous Selecting this menu item will display the Edit EXE Properties dialog which lets you modify various properties of the currently displayed EXE or DLL file. The following properties can be edited: Name Description Application Type Stack Size Heap Size Long File Name Support ═══ Report... ═══ Next Previous Selecting this menu item will allow you to dump header and table information to a file. A Save File dialog will be displayed which will let you select the file to save to. ═══ Save ═══ Next Previous Selecting this menu item will allow you to save any changes that you have made to the currently viewed file. If no changes have been made this menu item will be disabled. If this option is selected you will be asked for confirmation before the save is actually performed. CAUTION: The save command will replace the contents of the file you are working with. You may want to make a backup copy of the file before performing the save. ═══ Save As... ═══ Next Previous Selecting this menu item will allow you to save any changes that you have made to the currently viewed file to a different file. A Save File dialog will be displayed which will let you choose the file to save to. If the file already exists, you will be notified via the File Exists dialog. ═══ Exit ═══ Next Previous Selecting this menu item will exit the application and close any open windows. If any changes have been made to any of the open windows, you will be given the opportunity to save, discard or cancel the Exit command. ═══ 4.1.2. Toolbox ═══ Next Previous The toolbox facility of EXE Tool allows you to easily invoke programs that you commonly use. Programs you might want to easily invoke could be a dialog editor, icon editor, text editor, etc. The content of the Toolbox menu can vary. At a minimum, the Set Toolbox... item will always be available. The items in the Toolbox menu are derived from your 'toolbox' program group. Program groups are defined through the Desktop Manager. By selecting the Set Toolbox... item, you can tell EXE Tool the name of the program group that you wish to use as your 'toolbox'. This group would probably contain program definitions for tools you would commonly use in conjunction with EXE Tool. As an example, if you told EXE Tool that the group 'Main' was your 'toolbox', the menu items contained in the Toolbox menu would be the names of all the programs defined in the Main group. Selecting the program name from the menu will cause the program to execute. The following items always appear on the Toolbox menu: Set Toolbox... Next Previous ═══ Set Toolbox... ═══ Next Previous Selecting this menu item will cause the Set Toolbox dialog to be displayed. This dialog lets you select the name of the program group that is to be used as your 'toolbox'. ═══ 4.1.3. Options ═══ Next Previous The following items appear on the Options menu: Preferences... Display Fonts... Header ═══ Preferences... ═══ Next Previous Selecting this menu item will cause the Preferences dialog to be displayed. This dialog lets you set and modify EXE Tool preferences. ═══ Display Fonts... ═══ Next Previous Selecting this menu item will cause a Font Selection dialog to be displayed. This dialog will let you select the Font and Font Size used in the display window. The font selection will change the appearance in the current window. The font choice is saved and whenever a new window of this type is opened, it will use the saved font definition. exits. ═══ Header ═══ Next Previous Selecting this menu item will cause a submenu to appear displaying the following items: New EXE Header Selecting this menu item will cause the display area to show the contents of the 'new' EXE header. A check mark will appear by this menu item to indicate that the 'new' header is currently being displayed. Old EXE Header Selecting this menu item will cause the display area to show the contents of the 'old' EXE header. A check mark will appear by this menu item to indicate that the 'old' header is currently being displayed. ═══ 4.2. EXE Tool Buttons ═══ Next Previous The buttons in the button area may be selected either with the mouse or by using an 'Alt' combination. The underscored letter in the button title is the to use. Disabled buttons indicate that the current file does not currently have the table in question. The following buttons appear on the main window.: o Segment Table o Resource Table o Imported Names Table o Resident Names Table o Non-Resident Names Table ═══ 5. Segment Table Viewer ═══ Next Previous The Segment Table viewer presents a selectable list of all the segment found in the file. The segment number, type, size, length, file offset and flag values are displayed. Double-clicking on a segment will bring up a Segment Viewer which displays the contents of the segment. Figure 2 shows an example of the Segment Table Viewer. Figure 2. Segment Table Viewer Next Previous ═══ 5.1. Segment Table Viewer Menu ═══ Next Previous The following items appear on the Segment Table Viewer main menu: Options ═══ 5.1.1. Options ═══ Next Previous The following items appear on the Options menu: Display Fonts... ═══ Display Fonts... ═══ Next Previous Selecting this menu item will cause a Font Selection dialog to be displayed. This dialog will let you select the Font and Font Size used in the display window. The font selection will change the appearance in the current window. The font choice is saved and whenever a new window of this type is opened, it will use the saved font definition. ═══ 6. Segment Viewer ═══ Next Previous The Segment Viewer displays the contents of a segment in a split window. The left portion of the window shows the contents of the segment in hexadecimal notation. The right portion of the window displays the contents in ASCII. Non-printable characters are displayed as a period. Figure 3 shows an example of the Segment Viewer window. Figure 3. Segment Viewer Next Previous ═══ 6.1. Segment Viewer Menu ═══ Next Previous The following items appear on the Segment Viewer main menu: File ═══ 6.1.1. File ═══ Next Previous The following items appear on the File menu: Save As... ═══ Save As... ═══ Next Previous Selecting this menu item will let you save the contents of the segment to a file of your choosing. Once saved, the title is changed to indicate the name of the file to which the segment data was saved. ═══ 7. Resource Table Viewer ═══ Next Previous The Resource Table Viewer presents a selectable list of resources found in the file. The list shows the name id, type, length and flags assigned to each resource. The type of resources displayed in the list can be controlled via the View menu item. The default display will show the most common resources and exclude less common resources. The items in the View menu will always indicate whether or not all resources are currently displayed. If all items are displayed the 'All' item will be checked, if not, the 'Some...' item will be checked. Figure 4 shows an example of the Resource Table Viewer. Figure 4. Resource Table Viewer Next Previous ═══ 7.1. Viewing Resources ═══ Next Previous Individual resources can be viewed by double-clicking on items in the resource list or selecting one or more resources from the list and selecting the 'View' item from the 'Resource' menu. This will result in one or more Resource Viewers being opened, one for each resource selected. The content of a resource viewer will vary depending on the type of resource being viewed. ═══ 7.2. Manipulating Resources ═══ Next Previous EXE Tool gives you the ability to add, delete and modify properties of the resources found in a file. Editing of resources is done using other utilities. Resources can be 'cut' from, or 'pasted' to, the resource table (or resource file). Resources can be easily moved from one EXE/DLL/RES file to another using EXE Tool and the clipboard. The easiest way to do this is to open two (or more) EXETool windows and open the resource table for each one. Select the resources you wish to move from one of the resource tables and select the appropriate item from the Resource menu (Cut, Copy). Next, select the resource table for the file you want to modify. The Paste option of the Resource menu should be active. Select Paste to copy the resources from the clipboard to the resource table. If duplicate resources exist you will be notified via the Resource Exists dialog. ═══ 7.3. Integration with Other Tools ═══ Next Previous EXETool stores resources on the clipboard in a private format called 'Resource'. Dialogs are stored using both the 'Resource' format as well as the dialog format used by the Microsoft Dialog Editor. Using the clipboard, dialogs can be easily copied to and from the Microsoft Dialog Editor and EXE Tool. Any application that can read the 'Resource' format can work smoothly with EXE Tool. Modifying a Dialog Modifying a dialog which exists in an EXE/DLL/RES file is quite simple. First, open the resource table or file. Select the dialog you wish to edit. From the Resource menu, choose the Copy item. Start the dialog editor (This example assumes the MS Dialog Editor). From the dialog editor Edit menu choose Paste Dialog. You will be prompted for the ID to use for the dialog. You should enter the same ID as is used in the EXE/DLL/RES file you are editing. The dialog will now appear. Make whatever changes you want. When you are done, select Copy Dialog from the dialog editor Edit menu. Click on the resource table or resource file window where the dialog came from. Select Paste from the Resource menu. You will be told that a resource with the same name ID and type already exists. Press the Replace button. The new dialog is now stored in the resource table or file. To make your changes permanent you will have to perform a 'save' operation. If you are editing an EXE/DLL file, you will have to perform a Save or Save As... from the main window. If you are editing a resource file directly, you would use Save or Save As... from the File menu. Modifying a Bitmap/Pointer/Icon Modifying a bitmap is done in a different manner than for Dialogs because the Icon editor does not work with resources directly. To modify a bitmap open the resource table or file and select the bitmap/pointer/icon you wish to edit. From the Resource menu, choose the Save As... option. You will be presented with a Save File dialog. Enter the name of the file in which to save the bitmap. Make sure the 'Save in .RES Format' option is not checked. Invoke the Icon editor. Choose Open... from the File menu and enter the name of the file in which you just saved the bitmap. Make any changes you want. When you are done, save the file. Return to the resource table/resource file window. Select the Insert item from the Resource menu. A submenu will appear. From the submenu select Bitmap, Pointer, or Icon, depending on the type of resource you are working with. You will be presented with an Add Resource dialog. Enter the name of the file in which you saved your bitmap. In the Name ID field, enter the ID number of the resource. Press Enter or click on the Add button. You will be notified that a duplicate resource exists. Select the Replace button and your modified bitmap will be stored in the table or file. To make your changes permanent you will have to perform a 'save' operation. If you are editing an EXE/DLL file, you will have to perform a Save or Save As... from the main window. If you are editing a resource file directly, you would use Save or Save As... from the File menu. ═══ 7.4. Resource Table Viewer Menu ═══ Next Previous The following items appear on the Resource Table Viewer main menu: File Resource View Toolbox Options ═══ 7.4.1. File ═══ Next Previous The following items appear on the File menu: New .RES File... Open .RES File... ═══ New .RES File... ═══ Next Previous Selecting this menu item will let you open a new window on an empty resource file. The Open File dialog will be displayed which allows you to enter the name of the resource file you wish to view. The file should not exist. ═══ Open .RES File... ═══ Next Previous Selecting this menu item will let you open a new window used to view the contents of a resource file (.RES). The Open File dialog will be displayed which allows you to enter the name of the resource file you wish to view. The file must exist. If a valid name is given, the resource file viewer will be opened on the given file. ═══ 7.4.2. Resource ═══ Next Previous The following items appear on the Resource menu: Undo Undo All Cut Copy Paste Insert Delete Select All Edit Properties... View Save As... ═══ Undo ═══ Next Previous Selecting this menu item will cause the last edit action to be undone. The item will be disabled if no undoable action exists. ═══ Undo All ═══ Next Previous Selecting this menu item will cause the resource table to revert to the definition found in the file. This is a quick way to undo all unsaved changes to the resource table. ═══ Cut ═══ Next Previous Selecting this menu item will copy the currently selected resource(s) to the clipboard. After the copy is made, the resources will be removed from the resource list. ═══ Copy ═══ Next Previous Selecting this menu item will copy the currently selected resource(s) to the clipboard. The copied resources remain in the resource table. ═══ Paste ═══ Next Previous Selecting this menu item will cause the current contents of the clipboard to be inserted into the resource table. This item will only be active if there is a 'resource' on the clipboard. If duplicate resources are found (i.e. resources with the same name ID and type), the Resource Exists dialog will be displayed. ═══ Insert ═══ Next Previous Selecting this menu item will cause a submenu to appear listing the types of resources that may be inserted. Items that appear on the submenu are Bitmap... Dlginclude... Font... Icon... Pointer... User Defined... Resource File Contents... ═══ Bitmap... ═══ Next Previous Selecting this menu item will cause the Add Resource dialog to appear. This dialog allows you to enter the name of a file containing a bitmap resource and set the properties for the resource. ═══ Dlginclude... ═══ Next Previous Selecting this menu item will cause the Add Resource dialog to appear. This dialog allows you to enter the name of the .H file containing definitions used by dialogs. ═══ Font... ═══ Next Previous Selecting this menu item will cause the Add Resource dialog to appear. This dialog allows you to enter the name of a file containing a font resource and set the properties for the resource. ═══ Icon... ═══ Next Previous Selecting this menu item will cause the Add Resource dialog to appear. This dialog allows you to enter the name of a file containing a icon resource and set the properties for the resource. ═══ Pointer... ═══ Next Previous Selecting this menu item will cause the Add Resource dialog to appear. This dialog allows you to enter the name of a file containing a pointer resource and set the properties for the resource. ═══ User Defined... ═══ Next Previous Selecting this menu item will cause the Add Resource dialog to appear. This dialog allows you to enter the name of a file containing a user defined resource and set the properties of the resource. ═══ 7.4.3. Resource File Contents... ═══ Next Previous Selecting this menu item will cause the Add Resource File dialog to appear. This dialog allows you to enter the name of a file containing one or more resources. As each resource is added, you will be given the opportunity to reject or modify resources which have duplicate name and type ID's. An option exists on the dialog which allows you to automatically add all resources without being prompted when duplicates occur. ═══ Delete ═══ Next Previous Selecting this menu item will cause all selected resources in the list to be deleted from the table. The resources are not copied to the clipboard. ═══ Select All ═══ Next Previous Selecting this menu item will cause all resources in the list to be selected. ═══ Edit Properties... ═══ Next Previous Selecting this menu item will open the Edit Resource Properties dialog. This dialog lets you edit properties associated with the resource. Editable properties include memory management flags and resource name id. ═══ View ═══ Next Previous Selecting this menu item will open resource viewer windows for all selected resources. The type of viewer displayed will vary with the type of the resource. ═══ Save As... ═══ Next Previous Selecting this menu item will allow you to save the selected resource(s) to a file. A Save Resource dialog will be opened which allows you to enter the name of the file to save to. You will have the option of overwriting or appending to the selected file if it exists. ═══ 7.4.4. View ═══ Next Previous The following items appear on the View menu: All Some... ═══ All ═══ Next Previous Selecting this menu item will cause all resources to be displayed. The item will be checked if all resources are currently displayed. ═══ Some... ═══ Next Previous Selecting this menu item will allow you to select which resources you want to see in the list. The Resource List dialog will be opened which allows you to select the resource types you wan to view. ═══ 7.4.5. Toolbox ═══ Next Previous The toolbox facility of EXE Tool allows you to easily invoke programs that you commonly use. Programs you might want to easily invoke could include a dialog editor, icon editor, text editor, etc. The content of the Toolbox menu can vary. At a minimum, the Set Toolbox... item will always be available. The items in the Toolbox menu are derived from your 'toolbox' program group. Program groups are defined through the Desktop Manager. By selecting the Set Toolbox... item, you can tell EXE Tool the name of the program group that you wish to use as your 'toolbox'. This group would probably contain program definitions for tools you would commonly use in conjunction with EXE Tool. As an example, if you told EXE Tool that the group 'Main' was your 'toolbox', the menu items contained in the Toolbox menu would be the names of all the programs defined in the Main group. Selecting the program name from the menu will cause the program to execute. The following items always appear on the Toolbox menu: Set Toolbox... ═══ Set Toolbox... ═══ Next Previous Selecting this menu item will cause the Set Toolbox dialog to be displayed. This dialog lets you select the name of the program group that is to be used as your 'toolbox'. ═══ 7.4.6. Options ═══ Next Previous The following items appear on the Options menu: Display Fonts... ═══ Display Fonts... ═══ Next Previous Selecting this menu item will cause a Font Selection dialog to be displayed. This dialog will let you select the Font and Font Size used in the display window. The font selection will change the appearance in the current window. The font choice is saved and whenever a new window of this type is opened, it will use the saved font definition. ═══ 8. Resource File Viewer ═══ Next Previous The Resource File Viewer performs the same tasks as the Resource Table viewer. The only difference is that the Resource File viewer reads and manipulates information contained in a .RES format resource file whereas the Resource Table viewer manipulates resources contained in an EXE/DLL file. The differences between the two viewers are outlined below. ═══ 8.1. Resource Table Viewer Menu ═══ Next Previous The following menus are different than those which appear on the Resource Table Viewer main menu: File ═══ 8.1.1. File ═══ Next Previous The following items appear on the File menu: New Window New Open... Save Save As... ═══ New Window ═══ Next Previous Selecting this menu item will cause a new Resource File Viewer to be opened. The window is not associated with any file. You would generally use this option when you want to create a new .RES file and selectively add resources to it. ═══ New ═══ Next Previous Selecting this menu item will cause the current Resource File Viewer to be set to a null file. ═══ Open... ═══ Next Previous Selecting this menu item will display a Open File dialog which will let you choose a new .RES file to view. If any changes have been made to the current .RES file, you will be given the option of saving them before a new file is read. ═══ Save ═══ Next Previous Selecting this menu item will cause the current contents of the .RES file to be saved. This option is only active if modifications have been made to the file. ═══ Save As... ═══ Next Previous Selecting this menu item will allow you to save any changes that you have made to the currently viewed file to a different file. A Save File dialog will be displayed which will let you choose the file to save to. If the file already exists, you will be notified via the File Exists dialog. ═══ 9. Resource Viewers ═══ Next Previous EXETool has the ability to view individual resources. Most resources will be displayed with their .RC definition. Graphical resources (bitmaps, pointers and icons) are displayed with a bit viewer. Other resources will be displayed with a generic viewer showing the raw data bytes which define the resource. The following resource viewers are currently available: Accelerator Table Viewer Bitmap/Pointer/Icon Viewer Dialog Viewer Dialog Include Viewer Menu Viewer String Table Viewer Generic Viewer ═══ 9.1. Accelerator Table Viewer ═══ Next Previous The Accelerator Table Viewer displays an accelerator table resource definition in .RC format. Figure 5 shows an example Accelerator Table Viewer display. Figure 5. Accelerator Table Viewer Next Previous ═══ 9.1.1. Accelerator Table Viewer Menu ═══ Next Previous The following items appear on the Accelerator Table Viewer main menu: Edit Options ═══ 9.1.1.1. Edit ═══ Next Previous The following items appear on the Edit menu: Copy Select All Copy Resource ═══ Copy ═══ Next Previous Selecting this menu item will copy the selected text in the window to the clipboard. If there is no text selected, the menu item will be disabled. ═══ Select All ═══ Next Previous Selecting this menu item will cause all the text in the window to be selected. The text may then be copied to the clipboard via the Copy menu item. ═══ Copy Resource ═══ Next Previous Selecting this menu item will cause the current resource to be copied to the clipboard. The clipboard will contain the resource definition for the displayed resource, not the bitmap. ═══ 9.1.1.2. Options ═══ Next Previous The following items appear on the Options menu: Display Fonts... ═══ Display Fonts... ═══ Next Previous Selecting this menu item will cause a Font Selection dialog to be displayed. This dialog will let you select the Font and Font Size used in the display window. The font selection will change the appearance in the current window. The font choice is saved and whenever a new window of this type is opened, it will use the saved font definition. ═══ 9.2. Bitmap/Pointer/Icon Viewer ═══ Next Previous The Bitmap Viewer displays the graphic representation of a bitmap, pointer or icon. The display contains several sub-regions. One region displays the bitmap at its actual size. Another region displays an enlarged view of the bitmap. Another region displays information about the bitmap. If a bitmap contains multiple versions, you can view each version by selecting the desired version from the Device menu. Figure 6 shows an example Bitmap Viewer display. Figure 6. Bitmap Viewer Next Previous ═══ 9.2.1. Bitmap/Icon/Pointer Viewer Menu ═══ Next Previous The following items appear on the Bitmap Viewer main menu: Edit Devices Options ═══ 9.2.1.1. Edit ═══ Next Previous The following items appear on the Edit menu: Copy Resource ═══ Copy Resource ═══ Next Previous Selecting this menu item will cause the current resource to be copied to the clipboard. The clipboard will contain the resource definition for the displayed resource, not the bitmap. ═══ Devices ═══ Next Previous The items which appear on the Devices menu will vary depending on the number and type of bitmaps found in the resource. The items in the list indicate device specific bitmaps found in the resource. Selecting any of the menu items will cause the bitmap defined for the indicated device to be displayed. ═══ Options ═══ Next Previous The following items appear on the Options menu: Set Scale... Grid ═══ Set Scale... ═══ Next Previous Selecting this menu item will cause a Set Scale dialog to be displayed. This dialog will let you set the bitmap enlargement value. Each pixel in the bitmap will be multiplied by the number specified. ═══ Grid ═══ Next Previous Selecting this menu item will toggle the grid setting. When the grid is active, a grid will be superimposed on the bitmap enlargement. ═══ 9.3. Dialog Viewer ═══ Next Previous The Dialog Viewer displays a dialog resource definition in .RC format. The actual dialog may be viewed by selecting the Show Dialog item from the Options menu. The dialog can be dismissed by clicking anywhere on the dialog, or selecting the Show Dialog item a second time. Figure 7 shows an example Dialog Viewer display. Figure 7. Dialog Viewer Next Previous ═══ 9.3.1. Dialog Viewer Menu ═══ Next Previous The following items appear on the Menu Viewer main menu: Edit Options ═══ 9.3.1.1. Edit ═══ Next Previous The following items appear on the Edit menu: Copy Select All Copy Resource ═══ Copy ═══ Next Previous Selecting this menu item will copy the selected text in the window to the clipboard. If there is no text selected, the menu item will be disabled. ═══ Select All ═══ Next Previous Selecting this menu item will cause all the text in the window to be selected. The text may then be copied to the clipboard via the Copy menu item. ═══ Copy Resource ═══ Next Previous Selecting this menu item will cause the current resource to be copied to the clipboard. The clipboard will contain the resource definition for the displayed resource, not the bitmap. ═══ 9.3.1.2. Options ═══ Next Previous The following items appear on the Options menu: Display Fonts... Show Dialog ═══ Display Fonts... ═══ Next Previous Selecting this menu item will cause a Font Selection dialog to be displayed. This dialog will let you select the Font and Font Size used in the display window. The font selection will change the appearance in the current window. The font choice is saved and whenever a new window of this type is opened, it will use the saved font definition. ═══ Show Dialog ═══ Next Previous Selecting this menu item will cause the current dialog resource to be displayed on the screen. The dialog may be removed either by clicking on the dialog, or selecting this menu item a second time. ═══ 9.4. Dialog Include Viewer ═══ Next Previous The Dialog Include Viewer displays the name of the .H file specified in the DLGINCLUDE resource. Figure 8 shows an example Dialog Include Viewer display. Figure 8. Dialog Include Viewer Next Previous ═══ 9.4.1. Dialog Include Viewer Menu ═══ Next Previous The following items appear on the String Table Viewer main menu: Edit Options ═══ 9.4.1.1. Edit ═══ Next Previous The following items appear on the Edit menu: Copy Select All Copy Resource ═══ Copy ═══ Next Previous Selecting this menu item will copy the selected text in the window to the clipboard. If there is no text selected, the menu item will be disabled. ═══ Select All ═══ Next Previous Selecting this menu item will cause all the text in the window to be selected. The text may then be copied to the clipboard via the Copy menu item. ═══ Copy Resource ═══ Next Previous Selecting this menu item will cause the current resource to be copied to the clipboard. The clipboard will contain the resource definition for the displayed resource, not the bitmap. ═══ 9.4.1.2. Options ═══ Next Previous The following items appear on the Options menu: Display Fonts... ═══ Display Fonts... ═══ Next Previous Selecting this menu item will cause a Font Selection dialog to be displayed. This dialog will let you select the Font and Font Size used in the display window. The font selection will change the appearance in the current window. The font choice is saved and whenever a new window of this type is opened, it will use the saved font definition. ═══ 9.5. Menu Viewer ═══ Next Previous The Menu Viewer displays a menu resource definition in .RC format. Figure 9 shows an example Menu Viewer display. Figure 9. Menu Viewer Next Previous ═══ 9.5.1. Menu Viewer Menu ═══ Next Previous The following items appear on the Menu Viewer main menu: Edit Options ═══ 9.5.1.1. Edit ═══ Next Previous The following items appear on the Edit menu: Copy Select All Copy Resource ═══ Copy ═══ Next Previous Selecting this menu item will copy the selected text in the window to the clipboard. If there is no text selected, the menu item will be disabled. ═══ Select All ═══ Next Previous Selecting this menu item will cause all the text in the window to be selected. The text may then be copied to the clipboard via the Copy menu item. ═══ Copy Resource ═══ Next Previous Selecting this menu item will cause the current resource to be copied to the clipboard. The clipboard will contain the resource definition for the displayed resource, not the bitmap. ═══ 9.5.1.2. Options ═══ Next Previous The following items appear on the Options menu: Display Fonts... ═══ Display Fonts... ═══ Next Previous Selecting this menu item will cause a Font Selection dialog to be displayed. This dialog will let you select the Font and Font Size used in the display window. The font selection will change the appearance in the current window. The font choice is saved and whenever a new window of this type is opened, it will use the saved font definition. ═══ 9.6. String Table Viewer ═══ Next Previous The String Table Viewer displays a string table resource definition in .RC format. Figure 10 shows an example String Table Viewer display. Figure 10. String Table Viewer Next Previous ═══ 9.6.1. String Table Viewer Menu ═══ Next Previous The following items appear on the String Table Viewer main menu: Edit Options ═══ 9.6.1.1. Edit ═══ Next Previous The following items appear on the Edit menu: Copy Select All Copy Resource ═══ Copy ═══ Next Previous Selecting this menu item will copy the selected text in the window to the clipboard. If there is no text selected, the menu item will be disabled. ═══ Select All ═══ Next Previous Selecting this menu item will cause all the text in the window to be selected. The text may then be copied to the clipboard via the Copy menu item. ═══ Copy Resource ═══ Next Previous Selecting this menu item will cause the current resource to be copied to the clipboard. The clipboard will contain the resource definition for the displayed resource, not the bitmap. ═══ 9.6.1.2. Options ═══ Next Previous The following items appear on the Options menu: Display Fonts... ═══ Display Fonts... ═══ Next Previous Selecting this menu item will cause a Font Selection dialog to be displayed. This dialog will let you select the Font and Font Size used in the display window. The font selection will change the appearance in the current window. The font choice is saved and whenever a new window of this type is opened, it will use the saved font definition. ═══ 9.7. Generic Resource Viewer ═══ Next Previous The Generic Resource Viewer displays the resource data in a split window. The left portion of the window shows the data in hexadecimal notation. The right portion of the window displays the data in ASCII. Non-printable characters are displayed as a period. Figure 11 shows an example of the Generic Viewer window. Figure 11. Generic Resource Viewer Next Previous ═══ 9.7.1. Generic Resource Viewer Menu ═══ Next Previous The following items appear on the Generic Resource Viewer main menu: Edit ═══ 9.7.1.1. Edit ═══ Next Previous The following items appear on the Edit menu: Copy Resource ═══ Copy Resource ═══ Next Previous Selecting this menu item will cause the current resource to be copied to the clipboard. The clipboard will contain the resource definition for the displayed resource, not the bitmap. ═══ 10. Imported Names Table Viewer ═══ Next Previous The Imported Names Table Viewer displays a non-selectable list of function or module names which are to be dynamically linked at load time. Figure 12 shows an example of the Imported Names Table Viewer. Figure 12. Imported Names Table Viewer Next Previous ═══ 10.1. Imported Names Table Viewer Menu ═══ Next Previous The following items appear on the Imported Names Table Viewer main menu: Options ═══ 10.1.1. Options ═══ Next Previous The following items appear on the Options menu: Display Fonts... ═══ Display Fonts... ═══ Next Previous Selecting this menu item will cause a Font Selection dialog to be displayed. This dialog will let you select the Font and Font Size used in the display window. The font selection will change the appearance in the current window. The font choice is saved and whenever a new window of this type is opened, it will use the saved font definition. ═══ 11. Resident Names Table Viewer ═══ Next Previous The Resident Names Table Viewer displays a non-selectable list of all the entry points in the file that were defined with the EXPORTS statement in the DEF file but were not assigned ordinal numbers. The display shows the index, segment, offset within the segment, name and flags for each name. Figure 13 shows an example of the Resident Names Table Viewer. Figure 13. Resident Names Table Viewer Next Previous ═══ 11.1. Resident Names Table Viewer Menu ═══ Next Previous The following items appear on the Resident Names Table Viewer main menu: Options ═══ 11.1.1. Options ═══ Next Previous The following items appear on the Options menu: Display Fonts... Sort By ═══ Display Fonts... ═══ Next Previous Selecting this menu item will cause a Font Selection dialog to be displayed. This dialog will let you select the Font and Font Size used in the display window. The font selection will change the appearance in the current window. The font choice is saved and whenever a new window of this type is opened, it will use the saved font definition. ═══ Sort By ═══ Next Previous Selecting this menu item will cause a submenu to appear displaying the following sorting criteria: Index Selecting this menu item will cause the display list to be displayed in index order. The index item will be checked to indicate the current order. Name Selecting this menu item will cause the display list to be displayed in name order. The name item will be checked to indicate the current order. ═══ 12. Non-Resident Names Table Viewer ═══ Next Previous The Non-Resident Names Table Viewer displays a non-selectable list of all the entry points in the file that were defined with the EXPORTS statement in the DEF file and were assigned ordinal numbers. The display shows the index, segment, offset within the segment, name and flags for each name. Figure 14 shows an example of the Non-Resident Names Table Viewer. Figure 14. Non-Resident Names Table Viewer Next Previous ═══ 12.1. Non-Resident Names Table Viewer Menu ═══ Next Previous The following items appear on the Non-Resident Names Table Viewer main menu: Options ═══ 12.1.1. Options ═══ Next Previous The following items appear on the Options menu: Display Fonts... Sort By ═══ Display Fonts... ═══ Next Previous Selecting this menu item will cause a Font Selection dialog to be displayed. This dialog will let you select the Font and Font Size used in the display window. The font selection will change the appearance in the current window. The font choice is saved and whenever a new window of this type is opened, it will use the saved font definition. ═══ Sort By ═══ Next Previous Selecting this menu item will cause a submenu to appear displaying the following sorting criteria: Index Selecting this menu item will cause the display list to be displayed in index order. The index item will be checked to indicate the current order. Name Selecting this menu item will cause the display list to be displayed in name order. The name item will be checked to indicate the current order. ═══ 13. Dialogs ═══ Next Previous The following dialogs may appear or be selected at various times: Add Resource Add Resource File Edit EXE Properties Edit Resource Properties File Exists Font Selection Open File Preferences Resource Exists Resource List Save File Save Resource Set Scale Set Toolbox ═══ 13.1. Add Resource ═══ Next Previous The Add Resource dialog is used to add a particular resource type to a resource file or EXE/DLL resource table. When a standard resource is added (i.e. Bitmap, Dialog, String, etc.) the Type ID field is preset to the proper value and the memory flags are set to appropriate defaults. In most cases, you will only need to specify the Name ID for the resource. When adding a user defined resource, all values must be specified. Next Previous ═══ 13.2. Add Resource File ═══ Next Previous The Add Resource File dialog is used to add all of the resources found in a .RES file to the currently viewed resource file or resource table. There is a check box on the dialog which gives you the option to overwrite all duplicate resources that currently exist with those found in the file to be added. If this box is not checked, you will be prompted for action whenever a duplicate resource is found in the file being added. Next Previous ═══ 13.3. Edit EXE Properties ═══ Next Previous The Edit EXE Properties dialog is used to modify characteristics of the EXE or DLL file being viewed. The characteristics that can be changed include Name, Description, Stack Size, Heap Size, Application Type and Long File Name support. Next Previous ═══ 13.4. Edit Resource Properties ═══ Next Previous The Edit Resource Properties dialog is used to modify characteristics of a particular resource. Items that can be changed include memory options and name ID. Next Previous ═══ 13.5. File Exists ═══ Next Previous The File Exists dialog appears when a save operation would result in a file being overwritten. The dialog gives you the option of overwriting the file or canceling the operation. Note: When saving resources, a third option appears. This option allows you to append to the file instead of overwriting or canceling. Next Previous ═══ 13.6. Font Selection ═══ Next Previous The Font Selection dialog is used to select a font to be used by a display window. Next Previous ═══ 13.7. Open File ═══ Next Previous The Open File dialog is used to select a file to view. The file name may be selected by clicking on the directory and file name windows until the desired file is found. Alternatively, the entire file name may be specified in the file name edit field. Next Previous ═══ 13.8. Preferences ═══ Next Previous The Preferences dialog is used to establish default preference settings for EXE Tool. The settings are saved in the OS2.INI file. Next Previous ═══ 13.9. Resource Exists ═══ Next Previous The Resource Exists dialog appears when you attempt to add a resource to the current resource file or resource table that has the same resource type and same resource name id as one which already resides in the file. You are given the option of replacing the resource with the newer one, changing the name id of the newer one, or canceling the operation. Next Previous ═══ 13.10. Resource List ═══ Next Previous The Resource List dialog is used to choose the resources that you want to appear in the Resource Table viewer. The dialog presents a list of resource types. The highlighted resources in the list will be included in the viewer. Resources can be selected and deselected by clicking on the items in the list box. To select all resources, the All button may be clicked on. To clear all selected entries, the None button may be used. To return the list to standard defaults, the Default button may be used. Next Previous ═══ 13.11. Save File ═══ Next Previous The Save File dialog is used to choose the name of the file in which to save information. The dialog consists of an edit field, a directory list, a file list and action buttons. To save to a particular file you can type the full name in the edit field and press Enter (or select the Save button). Alternatively, you can click on items in the directory and file lists until you have reached the desired directory and/or file. If the file you select exists, you will be notified via the File Exists dialog and given the option to either overwrite the file, or cancel the save. If cancel is selected you will still be in the Save File dialog where you can choose another file or Cancel the entire save operation. Note: When saving resources, a third option will be available if the file exists. This option is Append. Choosing the Append option will save the contents of the selected resource(s) at the end of the given file. Next Previous ═══ 13.12. Save Resource ═══ Next Previous The Save Resource dialog is used to enter a file name in which to save a resource. There is an option on the dialog to save the resource in .RES format. If this option is not selected, only the resource data, not resource type information, will be saved. For example, if you wanted to save a bitmap resource in a format suitable for editing you would unselect the 'Save in .RES Format' option. Next Previous ═══ 13.13. Set Scale ═══ Next Previous The Set Scale dialog is used to alter the bitmap enlargement factor of the Bitmap Viewer. Next Previous ═══ 13.14. Set Toolbox ═══ Previous The Set Toolbox dialog is used to set the name of the 'toolbox' group. The items in the 'toolbox' group appear in the Toolbox menu. Previous ═══ ═══ BookMark When you place a bookmark on a topic, it is added to a list of bookmarks you have previously set. You can view the list, and you can remove one or all bookmarks from the list. If you have not set any bookmarks, the list is empty. To set a bookmark, do the following: 1. Select a topic from the Contents. 2. When that topic appears, choose the Bookmark option from the Services pull-down. 3. If you want to change the name used for the bookmark, type the new name in the field. 4. Click on the Place radio button (or press the Up or Down Arrow key to select it) 5. Click on OK (or select it and press Enter). The bookmark is then added to the bookmark list. ═══ ═══ Copy You can copy a topic you are viewing into a temporary file named TEXT.TMP. You can later edit that file by using the editor of your choice. To copy a topic, do the following: 1. Expand the Contents list and select a topic. 2. When the topic appears, choose Copy to file from the Services pull-down. 3. The system puts the text pertaining to that topic in the temporary TEXT.TMP file. For information on one of the other choices in the Services pull-down, highlight the choice and press the F1 key. ═══ ═══ Options You can control the appearance of the Contents list. To expand the Contents and show all levels for all topics, choose Expand all from the Options pull-down. You can also press the Ctrl and * keys together. For information on one of the other choices in the Options pull-down, highlight the choice and press the F1 key. ═══ ═══ Print You can print one or more topics. You can also print a set of topics by first marking the topics on the Contents list. To print the document Contents list, do the following: 1. Choose Print from the Services pull-down. 2. Click on Contents (or press the Up or Down Arrow key to select it) 3. Click on Print (or select it and press Enter). 4. The Contents list is printed on your printer. ═══ ═══ Search You can specify a word or phrase to be searched. You can also limit the search to a set of topics by first marking the topics on the Contents list. To search for a word or phrase in all topics, do the following: 1. Choose the Search option from the Services pull-down. 2. Type the word or words to be searched. 3. Click on All sections (or press the Up or Down Arrow keys to select it) 4. Click on Search (or select it and press Enter) to begin the search. 5. The list of topics where the word or phrase appears is displayed. If only one topic contains the word or phrase, a window containing that topic appears.