MenuTextBlock: Difference between revisions
No edit summary |
|||
(9 intermediate revisions by 2 users not shown) | |||
Line 2: | Line 2: | ||
== Description == | == Description == | ||
'''This control is part of iWebKit, which has been deprecated.''' | |||
The Menu control is used to give the user a choice what action to take next. Each item can have a description. | The Menu control is used to give the user a choice what action to take next. Each item can have a description. | ||
Line 14: | Line 16: | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| addItem(''textBlock'', ''item'') || Add ''textBlock'' to position ''item'' on the list. If ''item'' is not supplied, add to the end. | | addItem(''textBlock'', ''item'') || Add ''textBlock'' to position ''item'' on the list. If ''item'' is not supplied, add to the end. HTML is OK. | ||
|- | |- | ||
| deleteItem(''item'') || If ''item'' is not supplied, the last one is deleted. If “all”, all items are deleted. | | deleteItem(''item'') || If ''item'' is not supplied, the last one is deleted. If “all”, all items are deleted. | ||
Line 22: | Line 24: | ||
| getItemCount() || Returns the number of items | | getItemCount() || Returns the number of items | ||
|- | |- | ||
| textBlocks || A list of choices to be offered. The items are separated by | | textBlocks || A list of choices to be offered. The items are separated by vertical bar characters. Do not include quote signs or returns in the text. HTML is OK. (design time) | ||
|- | |- | ||
| refresh() || Recalculates the size of the scrolling area when first displayed. | | refresh() || Recalculates the size of the scrolling area when first displayed. | ||
Line 34: | Line 36: | ||
zoom: true/false. Allow two finger zoom in gesture? | zoom: true/false. Allow two finger zoom in gesture? | ||
The full list of options is documented here: | The full list of options is documented here: https://github.com/cubiq/iscroll | ||
|- | |- | ||
| scrolling || Allow choices in the menu to scoll? On or off. (design time) | | scrolling || Allow choices in the menu to scoll? On or off. (design time) | ||
Line 65: | Line 65: | ||
[[Category:Language Reference]] | [[Category:Language Reference]] | ||
[[Category:Controls]] | |||
[[Category:iWebKit]] |
Latest revision as of 12:01, 8 July 2019
Description
This control is part of iWebKit, which has been deprecated.
The Menu control is used to give the user a choice what action to take next. Each item can have a description.
You supply it with a list of items, and it will create one choice for each item. When the menu is first displayed, you need to call Controlname.refresh().
To add a Menu to your app, choose the MenuTextBlock icon in the Toolbar. Use the Property Editor to set the properties.
Properties and Methods
Standard properties are supported, plus:
addItem(textBlock, item) | Add textBlock to position item on the list. If item is not supplied, add to the end. HTML is OK. |
deleteItem(item) | If item is not supplied, the last one is deleted. If “all”, all items are deleted. |
getItem(i) | Returns the text of item i. |
getItemCount() | Returns the number of items |
textBlocks | A list of choices to be offered. The items are separated by vertical bar characters. Do not include quote signs or returns in the text. HTML is OK. (design time) |
refresh() | Recalculates the size of the scrolling area when first displayed. |
replaceItem(item, textBlock) | Replace an existing item |
scroll_options | This control makes use of iScroll. It has a number of options, including:
bounce: true/false. When the end of the scroll area is reached, should the image bounce? zoom: true/false. Allow two finger zoom in gesture? The full list of options is documented here: https://github.com/cubiq/iscroll |
scrolling | Allow choices in the menu to scoll? On or off. (design time) |
title | Optional. If supplied, will put a heading on top of the list. (design time) |
Events
In addition to the standard events, Menu has a modified version of onclick.
onclick(choice) | The number of the choice that was made, starting from 0. |
Example
Function iMenu1_onclick(choice) If TypeName(choice)= "object" Then Exit Function MsgBox "Menu item chosen: " & choice End Function