; ------------------------ MEMOPAD.TXT --------------------- ; ; This is the help text file for the MEMOPAD application. It ; includes the help text that a D-Flat application would use ; for the user interface. ; ; There can be a help window with a helptag name for each ; command in commands.h, each menu label on the menu bar ; as defined in menus.c, and each dialog box name in dialogs.c ; ; There can be other help windows as well. Some of them will ; be displayed as the result of hypertext and definition key ; words embedded in the help text of other help windows. Others ; can be implemented from within an application software system. ; ; Following is the format for a help window: ; ; ÚÄÄ (1st column of each line) ; ; ; anything with a semicolon in the 1st column is a comment ; (names the help window) ; [<<] (names the previous window in chain) ; [>>] (names the next window in chain) ; Help Window Title (displays in window's title bar) ; Help text follows until next helptag occurs ; Hypertext reference [..keyword] embedded in text ; Definition reference [**keyword] embedded in text ; (names another window) ; ; Notes: ; 1. A hypertext reference, when selected, causes the ; associated help window named by the to ; become the active help window. ; 2. A definition reference, when selected, displays ; a momentary window with the text of the associated ; help window named by the . The window ; closes when the user releases the Enter key or ; mouse button. ; 3. A definition window has no title. ; 4. The last window is followed by the helptag. ; 5. The window's height and width adjust to the text. ; 6. The [..], [**], and do not display and ; do not figure in the width of the line in which ; they occur. ; ; ----------------------------------------- [<<] [>>] Application Window The Application Window is the desktop for the application. The Application window contains the application's [..Document Windows]. Before you open any documents, the Application window is empty. The application window has an [..Action Bar] just below its [..Title Bar] and a [..Status Bar] at the bottom. Note that there might not be a title or status bar depending on the [..Display] option on the [..Options] menu. ; ----------------------------------------- [>>] The MEMOPAD Application MEMOPAD is a multi-window notepad program that demonstrates the programmer's [**API] to the D-Flat Common User Access interface library. ; ----------------------------------------- [<<] The MEMOPAD Document Window This [..Document Window] is a basic notepad text editor. You can have many of these windows open at one time. ; ----------------------------------------- Document Window A Document Window contains the data that you work on. It displays within the [..Application Window] and consists of these parts: [..Client Area] [..Border] [..Title Bar] [..Status Bar] [..Scroll Bars] [..Control Box] [..Minimize Box] [..Maximize Box] [..Restore Box] [..Resize Box] ; ----------------------------------------- [<<] [>>] Client Area The Client Area is the space inside the window's borders where the application's data values are displayed and manipulated. ; ----------------------------------------- [<<] [>>] Border The Border is the frame around a window. When the window has the focus, the border is a double line. When a different window has the focus, the border is a single line. The window's [..Scroll Bars], if any, are positioned in the right and bottom parts of the border. ; ----------------------------------------- [<<] [>>] Title Bar The Title Bar is at the top of the window and contains the window's title. When the window has the focus, the title is highlighted. The Title Bar includes these items as well: [..Control Box] [..Minimize Box] [..Maximize Box] [..Restore Box] You can move the window with the mouse by clicking the title bar and dragging the window to its new location. ; ----------------------------------------- [<<] [>>] Status Bar The Status Bar is at the bottom of the application window. It displays the time and brief contextual messages about the menus and other application-dependent features. ; ----------------------------------------- [<<] [>>] Scroll Bars You use Scroll Bars to scroll a window's data with the mouse. A window can have one or two Scroll Bars - one at the right and one at the bottom parts of the window's Border. The Scroll Bar at the right scrolls the document's data up and down. The Scroll Bar on the bottom scrolls the window's data right and left. To scroll a window a line at a time, click the arrow tokens at either end of the Scroll Bar. The Scroll Bar includes a slider box that indicates the relative position of the window's display with respect to the total document. You can page to an approximate position within the document by clicking inside the Scroll Bar. You can drag the slider box in either direction to scroll the document. ; ----------------------------------------- [<<] [>>] Control Box The Control Box is indicated by the character (ð) at the left end of the window's [..Title Bar]. You can click it to select the System Menu or double click it to close the window. ; ----------------------------------------- [<<] [>>] Minimize Box The Minimize Box is the token at the right end of the window's [..Title Bar]. When you click on the Minimize Box, the window is reduced to an icon at the bottom of the [..Application Window] ; ----------------------------------------- [<<] [>>] Maximize Box The Maximize Box is the token at the right end of the window's [..Title Bar]. When you click on the Maximize Box, the window grows to occupy the entire [..Client Area] of the [..Application Window] ; ----------------------------------------- [<<] [>>] Restore Box The Restore Box is the token character at the right end of a minimized window's [..Title Bar] and the token character at the right end of a maximized window's Title Bar. You click the Restore Box to restore the window to the position and size it had before it was minimized or maximized. ; ----------------------------------------- [<<] Resize Box The Resize Box is the lower right corner of the window's border. To change the window's size, drag the Resize Box. The window's upper left coordinates remain the same, and the lower right coordinates change as you drag the mouse around. ; ----------------------------------------- [<<] [>>] The Action Bar To select the action bar, do one of these: 1. Press F10 2. Press and release the Alt key 3. Press Alt+the letter that is highlighted in a menu's title on the action bar. The selected menu will pull down. 4. Click the action bar. If you click a pull-down menu selection's title, that menu will pull down. To exit from the action bar and return to the document or application window, do one of these: 1. Press Esc 2. Press and release the Alt key ; ----------------------------------------- ; ; Following are the Help system windows ; ; ----------------------------------------- [<<] [>>] Help for Help Getting Into the Help System ---------------------------- There are three ways to get into the Help system: 1. Execute commands on the [..Help] menu 2. Press F1 3. Press the Help command button on a dialog box. Contextual Help (F1) -------------------- The F1 key provides contextual help--help for the part of the application that currently has the focus. You can press F1 with the action bar selected, a pull-down menu displayed, a field on a dialog box selected, or a document window in focus. The Help Command Button ----------------------- The Help command button on a dialog box displays information about the dialog box and its purpose. The help window that displays when you press F1 with a dialog box field selected relates to the field itself. References to Other Help Windows -------------------------------- A Help window can include a reference to another help window. That reference is highlighted like this: [..Help] You can Tab to the highlighted reference and press the Enter key to select the referenced help window. You can select it with the mouse by double-clicking on it. Definitions ----------- Some references, such as [**function key], are definitions of terms. These definitions are highlighted the same as references. When you select the definition, a window displays in the upper left corner of the desktop. The window contains the definition of the selected term and stays in view until you release the Enter key or the mouse button. Command Buttons on the Help Windows ----------------------------------- Each help window contains these [..command buttons]: Close This button closes the help window and exits from the help system. Back This button changes to the help window that you viewed before the current one. Prev This button changes to the help window that logically preceeds the current one. Next This button changes to the help window that logically follows the current one. Exiting from the Help System ---------------------------- You exit from the Help system by closing the current help window in one of these three ways: 1. Press the Esc key 2. Use the Close command button on the Help window. 5. Double click the window's [..Control Box]. 4. Close the help window from its [..System Menu]. ; ----------------------------------------- [<<] [>>] Extended Help The MEMOPAD program has few features and procedures that are not taken directly from the SAA/CUA interface that D-Flat implements. The [..Log Messages] and [..Display] selections on the [..Options] menu are unique to MEMOPAD and would not necessarily be in an application. Some of the Display features would be useful to a user who is not developing D-Flat programs. Others, such as the [..Title], [..Border], [..Status Bar], and [..Texture] check boxes on the [..Display] dialog box, are to allow a programmer to see how the screen looks with these features enabled and disabled. ; ----------------------------------------- [<<] [>>] Keys Help From the Desktop ---------------- Alt+Hyphen Open the desktop's [..SystemMenu]. F10 or Alt Activate the [..ActionBar]. Esc Deactivate the Action Bar. Alt+letter Open the associated [..Pull-down menu]. Alt+F6 Change focus to another document. Alt+X Exit the application. From a [..Document Window] ---------------------- Alt+Spacebar Open the window's [..System Menu] Alt+S Save the document to a disk file. [..Edit Box] Keys ----------- Arrow keys Move the cursor one character. Ctrl+arrow Move the cursor one word. Del Delete character to the right of the cursor. If a [..block] is marked, delete the block. Backspace Delete character to the left of the cursor. If a block is marked, delete the block. Alt+BackSpace Undo the last block deletion. PgUp/PgDn Scroll forward and back one page. Ctrl+PgUp/PgDn Scroll horizontally one page. Home/End Move the cursor to the beginning and end of the line. Ctrl+Home/End Move the cursor to the beginning and end of the document. Alt+P Form a paragraph from the cursor position to the next blank line. Ins Toggle Insert/Overstrike mode. Tab Tab to the next Tab Stop position. [..Clipboard] Keys -------------- Shift+Del [..Cut] the marked text to the Clipboard Ctrl+Ins [..Copy] the marked text to the Clipboard. Shift+Ins [..Paste] the contents of the Clipboard into the document. [..Dialog Box]