Target property

BrowseButton.Target — BrowseTarget

Special value available in formulas:

Item

BrowseButton

The button this property is part of, enabling multiple checked items in the app designer to share the same formula and be updated all at once.

Consider the fields Field1 and Field2, which should only be considered to be valid if their values are greater than 4. Without using the Item value, the Valid property of Field1 would need to use the formula Field1 > 4Field1 > 4 and the Valid property of Field2 would need to use the formula Field2 > 4Field2 > 4.

Using Item, both formulas can read Item > 4Item > 4. This is useful if you have many fields and you want to be able to update their formulas all at once. To do so, click their check boxes in Calcapp Creator and make sure that a checked field is selected. Then, when you update a formula for one checked field, you update all the other checked fields too, which is a great timesaver.

Use Item in exactly the same way you'd use the regular name. Button1.VisibleButton1,Visible and Item.VisibleItem,Visible are equivalent, for instance.

The target where a web page is opened. These are the allowed values:

Value Meaning
BrowseTarget.​Default The behavior depends on the default browse targets. This setting may be changed in Calcapp Creator, in the inspector for the start screen of your app, under Browse target. If the default setting is used, the web page is opened in a new window or tab (equivalent to BrowseTarget.​Self), but only if the app is run as a standalone app. If the app is embedded in a website, the web page is opened in the current tab or window (equivalent to BrowseTarget.​Top).
BrowseTarget.​Self The web page is opened in the current tab or window. If the app is embedded in a website, the web page replaces the app (the iframe it is part of), but not the web page as a whole.
BrowseTarget.​Blank The web page is opened in a new tab or window.
BrowseTarget.​Parent The web page is opened in the current tab or window, if the app is run as a standalone app. If the app is embedded in a website, the web page replaces the parent of the iframe the app is part of. If the parent is another iframe, that iframe is replaced by the web page. If the parent is the top-level web page, the web page is opened in the current tab or window.
BrowseTarget.​Top The web page is opened in the current tab or window, if the app is run as a standalone app. If the app is embedded in a website, the web page is opened in the current tab or window.
BrowseTarget.​Named The web page is opened in a new tab or window with the name indicated by the NamedTarget property. If a web page has not already been opened in a tab or window with the given name, a new tab or window is opened. Otherwise, the web page is opened in the tab or window with the given name.

Examples

BrowseTarget.BlankBrowseTarget,Blank

Makes a browse button open its web page in a new tab or window.

BROWSE("https://www.calcapp.net", BrowseTarget.Blank)BROWSE("https://www.calcapp.net"; BrowseTarget,Blank)

This formula is associated with the OnPress property of a formula button, and causes https://www.calcapp.net to be opened in a new window or tab.