ZScript menus
Note: This feature is for ZScript only. |
As of GZDoom 2.4, most of the internal menu handling has been exported to ZScript, allowing for modders to create flexible and highly customizable menus. However, menus are also (one of) the most complex systems to work with in ZScript. Knowledge on the workings and mechanics of ZScript itself may help.
General Information
Before starting, knowing the scope system is highly recommended. Every menu and function except for Menu.SetMenu has a ui scope. This means only approved functions can access actors such as CountInv, which are marked within actors.txt as 'clearscope'.
Menus
Menus themselves are the very base foundations which hold items (see below), displaying and interacting them all on screen. Several types of menus are available:
Name | Description |
---|---|
Menu | The super class, inherited from by all menus internally. |
ListMenu | Used for Doom's main menu. |
OptionMenu | Used for most menus under the Options submenu. |
GenericMenu | A completely blank template for modders who wish to redesign menus in their own way. |
NOTE: For completely custom menus, inheritance must be done with GenericMenu, NOT the base menu!
Each of these can be inherited by a child class to gain functions and properties. GenericMenu simply inherits and does not change anything from the base Menu class except for initialization, while ListMenu and OptionMenu come with a plethora of menu items and pre-programmed functionality.
Menu Items
Items are referred to the objects being displayed on screen while inside a menu, regardless of interactive or static. All items inherit from the super class MenuItemBase.
For a more exhaustive listing of items, see the class pages directly.
Name | Parameters | Parent | Menu Type | Description |
---|---|---|---|---|
MenuItemBase | - | - | Super | The super class, inherited from by all menu items internally. |
OptionMenuItem |
|
MenuItemBase | OptionMenu | The base class for all items used in OptionMenus. Not usable by itself. |
ListMenuItem |
|
MenuItemBase | ListMenu | The base class for all items used in ListMenus. Not usable by itself. |