Recent changes to APP_MENU

APP_MENU modified by Benedict Jäggi

Benedict Jäggi — Wed, 20 Mar 2024 04:34:09 -0000

--- v5
+++ v6
@@ -50,12 +50,8 @@
 - Checks if the mouse is over a button when `ui.isMouseDown` is `True` to select the color-inverted button.
 - Also checks, if `UITools.showMsg` is `True`. It then does nothing except for drawing the buttons.

-####App: def onMouseDown(self)
-- Sets `App.onMouseDown `to `True`.
-
 ####App: def onMouseUp(self)
-- Sets `App.onMouseUp` to `False`
-- Checks, if mouse is over a button and calls the corresponding button function if so.
+- Checks, if mouse is released over a button and calls the corresponding button function then.

 -------

APP_MENU modified by Benedict Jäggi

Benedict Jäggi — Wed, 20 Mar 2024 04:33:01 -0000

--- v4
+++ v5
@@ -57,4 +57,7 @@
 - Sets `App.onMouseUp` to `False`
 - Checks, if mouse is over a button and calls the corresponding button function if so.

+-------
+
 That's all folks. Go back [Home] to have a look on the other Apps.
+

APP_MENU modified by Benedict Jäggi

Benedict Jäggi — Wed, 20 Mar 2024 04:32:42 -0000

--- v3
+++ v4
@@ -2,13 +2,17 @@
 #APP_MENU.py
 Go back [Home]

-A "widely" used menu app with 6 buttons to touch on.
+A "widely" used menu app with a default of 6 buttons to touch on.
 Each button has a name and can call a given function.

 Use the `cMenu` class to create your own menus or set the buttons of the actual selected menu directly.
 A `cMenu` instance will be created at startup automatically and be set to the `CURRENT_MENU`.

 ##Global Variables
+###buttonIndex
+The index of the last button where it was touched on.
+Use it to use the same button function on several buttons. Determine what to do with this index.
+
 ###CURRENT_MENU
 The actual shown and processed `cMenu`-instance.
 Set it directly to another one to change the menu.
@@ -16,34 +20,34 @@
 ------

 ##Functions
-###def nullfunc()
-A function which does absolutely nothing. Used for empty buttons.

-###def setMenuItem(buttonIdx, menuTitle, menuFunc)
+###def setMenuItem(buttonIdx, menuTitle, menuFunc, color)
 Calls `setMenuItem` on the `CURRENT_MENU`-instance.
+See below for further information.

 -------------

 ##Classes
 ###cMenu
-A menu class. It has 6 button items containing the text shown on the button and the function to be called.
+A menu class. It has a default of 6 button items containing the text shown on the button and the function to be called.
+Use x and y on creating the menu to use another button configuration, 
+e.g. `myMenu = APP_MENU.cMenu(4,2)` creates 4 buttons on 2 lines = 8 buttons with index 0 to 7.

-####cMenu: def setMenuItem(self, buttonIdx, menuTitle, menuFunc)
+####cMenu: def setMenuItem(self, buttonIdx, menuTitle, menuFunc, color)
 Set the button with index `buttonIdx` (0 to 5) to the given `menuTitle` and `menuFunc`.

 `buttonIdx` is the index of the button. Ranges from 0 to 5.
 `menuTitle` is the text shown on the corresponding button.
 `menuFunc` is the function that gets called when the button is touched. (Without () )
+`color` is the foreground color of the button. It can be ommitted. Default is `ui.fgcol`.

 ###App(APP_BASE.BaseAppClass)
 The App. See [APP_TEMPLATE] for further information.
-
-####App: mouseIsDown
-Set to `True` when the display is touched and to `False` when it is released.
+Draws the buttons and calls their functions when touched on.

 ####App: def update(self, screen, deltatime)
 - Draws the buttons. If the display is touched, it draws the touched button in inverted colors.
-- Checks if the mouse is over a button when `App.onMouseDown` is `True` to select the color-inverted button.
+- Checks if the mouse is over a button when `ui.isMouseDown` is `True` to select the color-inverted button.
 - Also checks, if `UITools.showMsg` is `True`. It then does nothing except for drawing the buttons.

 ####App: def onMouseDown(self)

APP_MENU modified by Benedict Jäggi

Benedict Jäggi — Fri, 08 Mar 2024 21:47:29 -0000

--- v2
+++ v3
@@ -1,3 +1,4 @@
+[TOC]
 #APP_MENU.py
 Go back [Home]

APP_MENU modified by Benedict Jäggi

Benedict Jäggi — Fri, 08 Mar 2024 21:35:43 -0000

--- v1
+++ v2
@@ -34,7 +34,6 @@
 `menuTitle` is the text shown on the corresponding button.
 `menuFunc` is the function that gets called when the button is touched. (Without () )

-
 ###App(APP_BASE.BaseAppClass)
 The App. See [APP_TEMPLATE] for further information.

APP_MENU modified by Benedict Jäggi

Benedict Jäggi — Fri, 08 Mar 2024 21:34:52 -0000

APP_MENU.py

Go back [Home]

A "widely" used menu app with 6 buttons to touch on.
Each button has a name and can call a given function.

Use the cMenu class to create your own menus or set the buttons of the actual selected menu directly.
A cMenu instance will be created at startup automatically and be set to the CURRENT_MENU.

Global Variables

CURRENT_MENU

The actual shown and processed cMenu-instance.
Set it directly to another one to change the menu.

Functions

def nullfunc()

A function which does absolutely nothing. Used for empty buttons.

def setMenuItem(buttonIdx, menuTitle, menuFunc)

Calls setMenuItem on the CURRENT_MENU-instance.

Classes

cMenu

A menu class. It has 6 button items containing the text shown on the button and the function to be called.

cMenu: def setMenuItem(self, buttonIdx, menuTitle, menuFunc)

Set the button with index buttonIdx (0 to 5) to the given menuTitle and menuFunc.

buttonIdx is the index of the button. Ranges from 0 to 5.
menuTitle is the text shown on the corresponding button.
menuFunc is the function that gets called when the button is touched. (Without () )

App(APP_BASE.BaseAppClass)

The App. See [APP_TEMPLATE] for further information.

App: mouseIsDown

Set to True when the display is touched and to False when it is released.

App: def update(self, screen, deltatime)

Draws the buttons. If the display is touched, it draws the touched button in inverted colors.
Checks if the mouse is over a button when App.onMouseDown is True to select the color-inverted button.
Also checks, if UITools.showMsg is True. It then does nothing except for drawing the buttons.

App: def onMouseDown(self)

Sets App.onMouseDownto True.

App: def onMouseUp(self)

Sets App.onMouseUp to False
Checks, if mouse is over a button and calls the corresponding button function if so.

That's all folks. Go back [Home] to have a look on the other Apps.