Well, the tag
Clear1st is not supported by
scui.Set because its logic is different from any other tag, and that's because it supposed to be set at the creation time, when the string box is defined.
IMO it has not sense to give the ability to the programmer to set the tag in the middle of the code, because the string must be cleared only one time and only the first time it's activated.
So the right way to use
Clear1st is at creation time like below:
Code:
scui.NewObject( #IFOCLASS_STRINGBOX,
"StringBox1",
{ x = 10, y = 168 },
{ x = 460, y = 20 },
{ Enabled = #IFO_ENABLED },
{ Values = { "Custom character filter..." }, Lines = 1,
InputType = #GETKEY_CUSTOM,
Custom = "ABC123",
Clear1st = 1,
MaxLen = 100, },
{ OnExit = myFunc1, OnChange = myFunc2, OnKeyPress = myFunc3 } )
If you need to set the tag at runtime this is not really a problem, I can implement it in no time, but I think that the tag should be changed in <ClearAtNextActivation> or something similar.
About the tag
Position it is true that during the creation there isn't a tag with this name because the coordinates are passed in a table but this choice has been done to keep thinks separated: class, name, position, size, and so on... it's simplier for me checking this pieces if they are empty or not, or valid or not while it's more complicated check a nasted and huge table with all parameters inside, something like:
Code:
scui.NewObject({ class = #IFOCLASS_LABEL,
name = "myLabel",
position = { x = 100, y = 100 },
size = { x = 400, y = 20 },
...})
I'm not saying that it's impossible because with programming almost is possible but it's more complex, if you think that with this change the code will be more clear and clean then I can plan this change
And yes, the documentation it's far to be complete, so don't esistate to ask because in this way I can have an idea of which areas needs more examples (like now), and I try to answer here with appropriate code ; this will help for sure the next releases documentation.
cya mate
Fabio
P.S.: If you need to create tips for your application you can dedicate a label for this purpose, everytime a StringBox is activated you can change the label's text with your String-related tip and when the StringBox is closed you can wipe the tip away with an empty text, maybe is less complex to handle and the user has the tip visible every time he activate the string and not only at the beginning of the program.
'night, it's pretty late! O_o'