RecipeSelectUnit() function

The RecipeSelectUnit() function opens the Select a Unit dialog box so that the run-time user can select a unit. The selected unit name is returned to a message tag. Both the RecipeSelectRecipe() and RecipeSelectUnit() functions are used in conjunction with the RecipeLoad() function.

Category

Recipe

Syntax

RecipeSelectUnit("Filename","UnitName",Number);

Arguments

FileName

Name of the recipe template file. The FileName argument can be a string constant or a message tag containing the name of the recipe template file.

UnitName

Message tag to which the name of the selected unit is written. Actual message tag without quotes or a string literal.

Number

Maximum string length returned to the argument. In InTouch, string (message) tags have a maximum length of 131 characters. Use 131 for this argument unless you have reduced the maximum string length of the InTouch tag. Number or integer tag.

Example

The following statement causes the Select a Unit dialog box to open:

RecipeSelectUnit("c:\recipe\recfile.csv", UnitName, 131);

After a Unit is selected, its name is returned to the UnitName tag.