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. |