User

From HSYCO
Revision as of 11:44, 6 February 2014 by Hsyco (talk | contribs) (→‎Parameters)
Jump to navigation Jump to search
Note  For a description and a complete list of UI Objects, see UI Objects.

A button used to execute customized Java code or generate events for the EVENTS interpreter. Pressing this button, HSYCO calls the method:

userCommand(String name, String param)

in the user.class class. HSYCO also executes all actions associated to the event:

USER name=param

defined in EVENTS. For a tutorial on how to use this object see Working with User objects. A long press will repeat the request every second.

It has several colors (depending on the skin) and three different sizes:

  • user (standard size)
UI Object link.png
  • usermini (medium size)
UI Object linkmini.png
  • usermicro (small size)
UI Object linkmicro.png

For a custom image version, see UserImage.

For an object with a list of user commands, see UserList.

Parameters

  • id: the object's ID, used by UISets. Required
  • name: name passed to the Java callback method and event in EVENTS
  • parameter: parameter passed to the Java callback method and event in EVENTS
  • position: the object's position. Use the pixels or rows and columns coordinates format
  • color: the color of the button. It can assume any of the skin's color values (E.g. for the "blue" skin, the possible values are: b - blue; g - green; gr - gray; r - red; y - yellow; glass)
  • label: the text label on the button. It can contain HTML tags
  • repeat: if "enabled", the command will be repeat every second

Syntax

(user[!<id>] <name>; <parameter>; <position>; <color>; <label>)

(usermini[!<id>] <name>; <parameter>; <position>; <color>; <label>)

(usermicro[!<id>] <name>; <parameter>; <position>; <color>; <label>)

E.g.

(user!user1 name; param; r3c1; gr; label; enabled)

(usermini!user1 name; param; r3c1; b; label;)

(usermicro!user1 name; param; x0y10; r; label;)

UI Attributes

Common attributes

Name Value Description
pos x<x>y<y> Position specified as x/y coordinates. E.g. x-5y10
r<r>c<c> Position specified as row/column. E.g. r1c2
visible true Default. Show the object
false Hide the object
blink true | slow Blink the object at a slow speed
fast Blink the object at a fast speed
false Stop the blinking
opacity 0.0 ... 1.0 Object opacity from 0 (not visible) to 1 (fully visible)

Button attributes

Name Value Description
color r,g,b... Set the button's color. Colors vary depending on the selected skin
enabled true Default. Enable the button
false Disable the button