Difference between revisions of "User"
Jump to navigation
Jump to search
Line 1: | Line 1: | ||
− | {{UI Object Header}}[[ | + | {{UI Object Header}} |
+ | 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]] | ||
+ | |||
+ | It has several colors (depending on the skin) and three different sizes: | ||
+ | * '''user''' (standard size) | ||
+ | :[[File:UI Object link.png]] | ||
+ | * '''usermini''' (medium size) | ||
+ | :[[File:UI Object linkmini.png]] | ||
+ | * '''usermicro''' (small size) | ||
+ | :[[File:UI Object linkmicro.png]] | ||
+ | * '''dlink''' (big size) | ||
+ | :[[File:UI Object dlink.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 | ||
+ | *'''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) | ||
+ | *'''page''': the name of the destination page associated to the button. It is possible to specify an absolute or relative URL in the '''page''' parameter. The tag will work as an <A HREF> tag, loading the new page. If the loaded page is an HSYCO menu, the '''back''' link will show up in the menu page, to reload the referrer page | ||
+ | *'''label''': the text label on the button. It can contain HTML tags | ||
+ | |||
+ | == Syntax == | ||
+ | (link[!<id>] <pos>; <color>; <page>; <label>) | ||
+ | |||
+ | (linkmini[!<id>] <pos>; <color>; <page>; <label>) | ||
+ | |||
+ | (linkmicro[!<id>] <pos>; <color>; <page>; <label>) | ||
+ | |||
+ | (dlink[!<id>] <pos>; <color>; <page>; <label>) | ||
+ | |||
+ | E.g. | ||
+ | (link!link1 x10y20; r; page1; Page 1) | ||
+ | |||
+ | (linkmini r0c1; glass; <nowiki>http://www.hsyco.com</nowiki>; hsyco) | ||
+ | |||
+ | (linkmicro x0y100; gr; /hsycohsyco/office; HSYCO Office) | ||
+ | |||
+ | (dlink!dlink1 x10y10; b; page1; <nowiki>Larger text<br>with <b>HTML</b></nowiki> tags) | ||
+ | |||
+ | == UI Attributes == | ||
+ | {{UI Object Attributes (Common)}} | ||
+ | {{UI Object Attributes (Button)}} |
Revision as of 12:08, 27 January 2014
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
It has several colors (depending on the skin) and three different sizes:
- user (standard size)
- usermini (medium size)
- usermicro (small size)
- dlink (big size)
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
- 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)
- page: the name of the destination page associated to the button. It is possible to specify an absolute or relative URL in the page parameter. The tag will work as an <A HREF> tag, loading the new page. If the loaded page is an HSYCO menu, the back link will show up in the menu page, to reload the referrer page
- label: the text label on the button. It can contain HTML tags
Syntax
(link[!<id>] <pos>; <color>; <page>; <label>) (linkmini[!<id>] <pos>; <color>; <page>; <label>) (linkmicro[!<id>] <pos>; <color>; <page>; <label>) (dlink[!<id>] <pos>; <color>; <page>; <label>)
E.g.
(link!link1 x10y20; r; page1; Page 1) (linkmini r0c1; glass; http://www.hsyco.com; hsyco) (linkmicro x0y100; gr; /hsycohsyco/office; HSYCO Office) (dlink!dlink1 x10y10; b; page1; Larger text<br>with <b>HTML</b> tags)
UI Attributes
Common attributes
Name | Value | Description |
---|---|---|
pos | x<x>y<y> | Position specified as x/y coordinates. E.g. x-5y10 |
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) |
rotation | 0 ... 360 | Object rotation in degrees. Images are rotated around the center point, all other objects are rotated around the top left corner |
Button attributes
Name | Value | Description |
---|---|---|
style | red,green,blue... | Set the button's style (color). Styles vary depending on the selected skin |
enabled | true | Default. Enable the button |
false | Disable the button |