This XML file should only be used for documentation purposes. 0 B4XMenuPlus B4XMenuPlus Extension For B4XPages menu. Replacing B4XPages.AddMenuItem(). When a menu item Is selected, an event ( EventName_Tag() ) Is triggered. New features are added: • Add text item, checkbox, toogle or submenu on 3dot menu. • Add separator on 3dot menu. (two consecutive separators are not allowed and automatic suppressed ) (separator are not clickable) • Icons/Bitmaps can be displayed on the bar. Icons are created by FONTAWESOME and MATERIALICONS. Icon/bitmaps can also be toggle elements. • All items can be set enabled/disabled (gray out) • All items can be set visible/hidden. • All 3dot items can have also a icon. • Checkbox item. When selected, the status changes and the event is called with EventName_Tag( Checked ). • Toggle item. 1 to x rotating states possible. All elements of a toggle have the same Tag, but can have different icons. When selected, the state rotates to the next position and the event is called with EventName_Tag( State ). The state is 0 based. • Submenu. Multi level submenus can be created. These can also contain checkbox And/Or toggle elements. • All interaction based on the item Tag. DepenseOn: XUI, BitmapCreator Initialize Initialize the object. Callback: Callback module Root: B4XView that call EventName: Generic event name Code Example: <code> Private mp As B4XMenuPlus mp.Initialize( Me, Root, "MenuClick" ) mp.AddNItem( "Test", "Test Menu Item" ) mp.ShowMenu Private Sub B4XPage_MenuClick( Tag As String ) mp.MenuClick( Tag ) End Sub Private Sub MenuClick_Test() ... End Sub</code> Callback Object Root B4XView EventName String AddBarBmp Add bitmap menu item. (on Bar) The bitmap for disabled is generated. (gray out) Tag: Event to call. Format: EventName_Tag() Title: Text shown on menu item. bmp: Bitmap for enable, bitmap for disable is generated. (grayout) Tag String Title String bmp B4XBitmap AddBarIcon Add icon menu item. (on Bar) The icon for disabled is generated. (gray out) Tag: Event to call. Format: EventName_Tag() Title: Text shown on menu item. isAwesome True = FONTAWESOME, False = MATERIALICONS mChar: Icon Picker Char. color: Color of icon. Boolean Tag String Title String isAwesome Boolean mChar String color Int AddBarToggleBmp Add bitmap toggle menu item. (on Bar) All items with the same Tag are in the same toggle item. These items rotate on every selection. Tag: Event to call. Format: EventName_Tag( state ) Title: Text shown on menu item. bmp: Bitmap for enable, bitmap for disable is generated. (grayout) Return: True = ok, False = see Error for details. Boolean Tag String Title String bmp B4XBitmap AddBarToggleIcon Add icon toggle menu item. (on Bar) All items with the same Tag are in the same toggle item. These items rotate on every selection. Tag: Event to call. Format: EventName_Tag( state ) Title: Text shown on menu item. isAwesome True = FONTAWESOME, False = MATERIALICONS mChar: Icon Picker Char. color: Color of icon. Return: True = ok, False = see Error for details. Boolean Tag String Title String isAwesome Boolean mChar String color Int AddItem Add text menu item. (in 3-dot menu) Tag: Event to call. Format: EventName_Tag() Title: Text shown on menu item. Tag String Title String AddItemIcon Add text menu item with icon. (in 3-dot menu) Tag: Event to call. Format: EventName_Tag() Title: Text shown on menu item. isAwesome True = FONTAWESOME, False = MATERIALICONS mChar: Icon Picker Char. color: Color of icon. Tag String Title String isAwesome Boolean mChar String color Int AddCheckbox Add checkbox menu item. (in 3-dot menu) Tag: Event to call. Format: EventName_Tag( checked ) Title: Text shown on menu item. checked: Checked or unchecked. Tag String Title String checked Boolean AddToggle Add toggle menu item. (in 3-dot menu) All items with the same Tag are in the same toggle item. These items rotate on every selection. Tag: Event to call. Format: EventName_Tag( state ) Title: Text shown on menu item. Return: True = ok, False = see Error for details. Boolean Tag String Title String AddToggleIcon Add toggle menu item with icon. (in 3-dot menu) All items with the same Tag are in the same toggle item. These items rotate on every selection. Tag: Event to call. Format: EventName_Tag( state ) Title: Text shown on menu item. isAwesome True = FONTAWESOME, False = MATERIALICONS mChar: Icon Picker Char. color: Color of icon. Return: True = ok, False = see Error for details. Boolean Tag String Title String isAwesome Boolean mChar String color Int AddSeparator Add separator menu item. (in 3-dot menu) AddSubMenu Creata a new submenu item. (in 3-dot menu) This item is the parentTag for items inside the sub. The submenu can be composed of text, checkbox or toggle items. Tag: ParentTag. (no event called) Title: Text shown on menu item. Return: True = ok, False = see Error for details. For all instances using submenu, add this lines in Main.<code> Sub Activity_WindowFocusChanged (Focused As Boolean) If B4XPages.[page].[B4XMenuPlus].IsInitialized Then B4XPages.[page].[B4XMenuPlus].WindowFocusChanged( Focused ) End Sub</code> Boolean Tag String Title String AddSubSubMenu Creata a new submenu item in submenu. (in 3-dot menu) This item is the parentTag for items inside the sub. The submenu can be composed of text, checkbox or toggle items. parentTag: Tag of the submenu. Tag: ParentTag. (no event called) Title: Text shown on menu item. Return: True = ok, False = see Error for details. For all instances using submenu, add this lines in Main.<code> Sub Activity_WindowFocusChanged (Focused As Boolean) If B4XPages.[page].[B4XMenuPlus].IsInitialized Then B4XPages.[page].[B4XMenuPlus].WindowFocusChanged( Focused ) End Sub</code> Boolean parentTag String Tag String Title String AddSubItem Add text menu item to a submenu. (in 3-dot menu) parentTag: Tag of the submenu. Tag: Event to call. Format: EventName_Tag() Title: Text shown on menu item. Return: True = ok, False = see Error for details. Boolean parentTag String Tag String Title String AddSubItemIcon Add text menu item to a submenu with icon. (in 3-dot menu) parentTag: Tag of the submenu. Title: Text shown on menu item. isAwesome True = FONTAWESOME, False = MATERIALICONS mChar: Icon Picker Char. color: Color of icon. Return: True = ok, False = see Error for details. Boolean parentTag String Tag String Title String isAwesome Boolean mChar String color Int AddSubCheckbox Add checkbox menu item to a submenu. (in 3-dot menu) parentTag: Tag of the submenu. Tag: Event to call. Format: EventName_Tag() Title: Text shown on menu item. checked: Checked or unchecked. Return: True = ok, False = see Error for details. Boolean parentTag String Tag String Title String checked Boolean AddSubToggle Add toggle menu item to a submenu. (in 3-dot menu) parentTag: Tag of the submenu. Tag: Event to call. Format: EventName_Tag() Title: Text shown on menu item. Return: True = ok, False = see Error for details. Boolean parentTag String Tag String Title String AddSubToggleIcon Add toggle menu item to a submenu with icon. (in 3-dot menu) parentTag: Tag of the submenu. Tag: Event to call. Format: EventName_Tag() Title: Text shown on menu item. isAwesome True = FONTAWESOME, False = MATERIALICONS mChar: Icon Picker Char. color: Color of icon. Return: True = ok, False = see Error for details. Boolean parentTag String Tag String Title String isAwesome Boolean mChar String color Int AddSubSeparator Add separator menu item. (in 3-dot menu) parentTag: Tag of the submenu. Return: True = ok, False = see Error for details. Boolean parentTag String GetEnabled Gets whether the menu item is enabled. (gray out) Tag: Tag to get enable. Return: True = enabled, False = disabled or see Error for details. Boolean Tag String SetEnabled Set enabled of the menu item. (gray out) Tag: Tag to enable. enable: True = enable, False = disable Return: True = ok, False = nok, see Error for details. Boolean Tag String enabled Boolean GetVisible Gets whether the menu item is visible or not. Tag: Tag to get visible. Return: True = hide, False = show or see Error for details. Boolean Tag String SetVisible Set visible of the menu item. Tag: Tag set the visible visible True = visible, False = hidden Return: True = ok, False = nok, see Error for details. Boolean Tag String visible Boolean GetCheck Gets whether the Checkbox menu item is checked or not. Tag: Tag to get check. Return: True = checked, False = unchecked or see Error for details. Boolean Tag String SetCheck CheckBox Item set check. Tag: Tag to get checked. checked True = check, False = uncheck Return: True = ok, False = nok, see Error for details. Boolean Tag String checked Boolean GetToggleState Get the state for Toggle item. (0 based) Tag: Tag of the Topggle-item. Return: State value or -1 = error, see Error for details. Int Tag String SetToggleState Set the state for Toggle item. (0 based) Tag: Tag of the Topggle-item. state: New state value. Return: True = ok, False = nok, see Error for details. Boolean Tag String state Int SetIconColor Set the color of the icon. (Bar icon and 3dot item with icon) Tag: Tag to change color. color: New color. Return: True = ok, False = nok, see Error for details. Boolean Tag String color Int SetToggleIconColor Set the color of the icon. (toggle item only) Tag: Tag to change color. state Toggle state. color: New color. Return: True = ok, False = nok, see Error for details. Boolean Tag String state Int color Int ShowMenu Build and show the menu with saved data. isActive is set to True. MenuClick Click on Menu item. Title: Title clicked on Return: True = ok, False = nok, see Error for details. Boolean Title String WindowFocusChanged Activity window focus changed. Used when submenu is closed without clicking on it. For all instances using submenu, add in this line Main.<code> Sub Activity_WindowFocusChanged (Focused As Boolean) If B4XPages.[page].[B4XMenuPlus].IsInitialized Then B4XPages.[page].[B4XMenuPlus].WindowFocusChanged( Focused ) End Sub</code> Focused Boolean ERROR_NO_ERROR Int ERROR_TITLE_NOT_FOUND Int ERROR_TAG_NOT_FOUND Int ERROR_ITEM_NOT_CHECK Int ERROR_ITEM_NOT_TOGGLE Int ERROR_PARENTTAG_NOT_FOUND Int ERROR_PARENTTAG_NOT_SUBMENU Int ERROR_WRONG_MENU_TYPE Int ERROR_ITEM_WRONG_TYPE Int ERROR_STATE_OUT_OF_RANGE Int ERROR_ITEM_IS_DISABLED Int ERROR_MENU_NOT_ACTIVE Int ERROR_CALLBACK_NOT_FOUND Int ERROR_ITEM_WITHOUT_ICON Int isActive Set B4XMenuClick active mode. Default is False, ShowMenu() set it to True. True - Menu is active, Callback and ShowMenu() is called on Set_...() False - Menu is inactive. No Callback or ShowMenu is called on Set_...() - MenuClick() will by return ERROR_NOT_ACTIVE. Boolean Error Get the Error of the last used function. Return: Error code. (ERROR_...) ERROR_NO_ERROR = 0 ERROR_TITLE_NOT_FOUND = -1, ERROR_TAG_NOT_FOUND = -2, ERROR_ITEM_NOT_CHECK = -3 ERROR_ITEM_NOT_TOGGLE = -4, ERROR_PARENTTAG_NOT_FOUND = -5, ERROR_PARENTTAG_NOT_SUBMENU = -6 ERROR_WRONG_MENU_TYPE = -7, ERROR_ITEM_WRONG_TYPE = -8, ERROR_STATE_OUT_OF_RANGE = -9 ERROR_ITEM_IS_DISABLED = -10, ERROR_MENU_NOT_ACTIVE = -11 ERROR_CALLBACK_NOT_FOUND = -12, ERROR_ITEM_WITHOUT_ICON = -13 Int 1.00 Gfy