This shows you the differences between two versions of the page.
| creating_menus [2021/10/26 12:09] – created admin | creating_menus [2021/10/26 12:13] (current) – admin | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | Creating Menus │ | + | ====== | 
| - | └───────────────────────────────────────────────────────────────────────┘ | + | |
| - | Your BBS's main menu MUST! be stored in a file called TOP.PBM. | + | Your BBS's main menu MUST! be stored in a file called TOP.PBM. | 
| - | other menus can have any file name you want to give them. | + | |
| - | When you select the 'Menu Editor' | + | When you select the 'Menu Editor' | 
| - | window will be opened containing the menus already available (if any). | + | |
| In this window, you can use the following keys: | In this window, you can use the following keys: | ||
| - |  | + | Up/ | 
| - |  | + | Enter | 
| - |  | + | Ins Add a menu. | 
| - | When you have selected a menu, a list of all the menu items will be | + | When you have selected a menu, a list of all the menu items will be displayed. To add a menu item, just move past the last item and press < | 
| - | displayed. To add a menu item, just move past the last item and press | + | |
| - | < | + | |
| - | edit a menu item, move the selector to that item and press < | + | |
| - | can change the menu prompt and highlight colors by pressing < | + | |
| - | you want to see how a menu will look, press < | + | |
| - | users will see when they view this menu. | + | |
| You can also copy and paste menu items. | You can also copy and paste menu items. | ||
| - | To copy an item, move to the item you want to copy, and press < | + | To copy an item, move to the item you want to copy, and press < | 
| - | insert the copied item somewhere else, move to the place where you want | + | |
| - | + | ||
| - | ───────────────────────────────────────────────────────────────────────────── | + | |
| - |  | + | |
| - | the menu item inserted, and press < | + | |
| - | items across different menus. | + | |
| A menu item has the following fields: | A menu item has the following fields: | ||
| - | ───────────────────────────────────── | ||
| - | |||
| - | Textline..................... This is the string to be displayed. | ||
| - | Leaving this field blank causes a blank | ||
| - | line to be displayed to the user. A CR/LF | ||
| - | will be sent after the menu line. To avoid | ||
| - | this, just enter a ';' | ||
| - | character. | ||
| - | textline of the menu to be appended to this | ||
| - | one. | ||
| - | |||
| - | Special textline characters: | ||
| - | |||
| - | ^ : Switches between normal and | ||
| - |  | ||
| - | ~ : Replaced by the number of minutes | ||
| - | the user has left in this session. | ||
| - | ` : Replaced by the name of the current | ||
| - |  | ||
| - |  | ||
| - | @ : Replaced by the name of the | ||
| - |  | ||
| - |  | ||
| - | |||
| - | This textline can also contain text macros | ||
| - | like @< | ||
| - | |||
| - | this in the "Text macros" | ||
| - | |||
| - | You are not limited to two colors in menu | ||
| - | lines. You can use the codes \1 to \7 to | ||
| - | change colors, or \0 to return to the | ||
| - | original color. | ||
| - | |||
| - | Hotkey....................... Most of the menu functions must be chosen | ||
| - | by the user, so ProBoard must react to | ||
| - | certain key-presses from the user. | ||
| - | Receiving the hotkey for a certain menu | ||
| - | item will cause ProBoard to execute the | ||
| - | function associated with this item. The | ||
| - | hotkey can be any ASCII character or | ||
| - | digit, but one character has a special | ||
| - | meaning to ProBoard: < | ||
| - | this function AUTOEXEC, which means that | ||
| - | this function will be executed as soon as | ||
| - | this menu item is displayed (without | ||
| - | really selecting this option). | ||
| - | |||
| - | Function..................... The function associated with this menu | ||
| - | item. Pressing the < | ||
| - | a complete list of all the menu functions | ||
| - | to be displayed in a separate window. | ||
| - | |||
| - | Data......................... This field is optional with some of the | ||
| - | functions. Basically, in this field you | ||
| - | enter the parameters of a menu function. | ||
| - | Eg. function 40 (Display ASC/ANS file) | ||
| - | |||
| - | ───────────────────────────────────────────────────────────────────────────── | ||
| - | 59 | ||
| - | needs a filename as data (parameter). | ||
| - | Function 1 (Goto menu) needs the name of | ||
| - | the menu to be jumped to. Text macros can | ||
| - | be inserted (see "Text macros" | ||
| - | |||
| - | Level........................ Level needed to access this menu item. | ||
| - | |||
| - | Flags........................ Flags needed to access this menu item. | ||
| - | |||
| - | Color........................ Color for the menu's textline to be | ||
| - | displayed in. | ||
| - | |||
| + | Textline..................... This is the string to be displayed. | ||
| + | Leaving this field blank causes a blank | ||
| + | line to be displayed to the user. A CR/LF | ||
| + | will be sent after the menu line. To avoid | ||
| + | this, just enter a ';' | ||
| + | character. | ||
| + | textline of the menu to be appended to this | ||
| + | one. | ||
| + | Special textline characters: | ||
| + | ^ : Switches between normal and | ||
| + |  | ||
| + | ~ : Replaced by the number of minutes | ||
| + | the user has left in this session. | ||
| + | ` : Replaced by the name of the current | ||
| + |  | ||
| + |  | ||
| + | @ : Replaced by the name of the | ||
| + |  | ||
| + |  | ||
| + | This textline can also contain text macros | ||
| + | like @< | ||
| + | this in the "Text macros" | ||
| + | You are not limited to two colors in menu | ||
| + | lines. You can use the codes \1 to \7 to | ||
| + | change colors, or \0 to return to the | ||
| + | original color. | ||
| + | Hotkey....................... Most of the menu functions must be chosen | ||
| + | by the user, so ProBoard must react to | ||
| + | certain key-presses from the user. | ||
| + | Receiving the hotkey for a certain menu | ||
| + | item will cause ProBoard to execute the | ||
| + | function associated with this item. The | ||
| + | hotkey can be any ASCII character or | ||
| + | digit, but one character has a special | ||
| + | meaning to ProBoard: < | ||
| + | this function AUTOEXEC, which means that | ||
| + | this function will be executed as soon as | ||
| + | this menu item is displayed (without | ||
| + | really selecting this option). | ||
| + | Function..................... The function associated with this menu | ||
| + | item. Pressing the < | ||
| + | a complete list of all the menu functions | ||
| + | to be displayed in a separate window. | ||
| + | Data......................... This field is optional with some of the | ||
| + | functions. Basically, in this field you | ||
| + | enter the parameters of a menu function. | ||
| + | Eg. function 40 (Display ASC/ANS file) | ||
| + | needs a filename as data (parameter). | ||
| + | Function 1 (Goto menu) needs the name of | ||
| + | the menu to be jumped to. Text macros can | ||
| + | be inserted (see "Text macros" | ||
| + | Level........................ Level needed to access this menu item. | ||
| + | Flags........................ Flags needed to access this menu item. | ||
| + | Color........................ Color for the menu's textline to be | ||
| + | displayed in. | ||