Difference between revisions of "UserImage"

From HSYCO
Jump to navigation Jump to search
Line 1: Line 1:
{{UI Object Header}}[[Category:INCOMPLETE]]
+
{{UI Object Header}}
 +
A clickable image similar to the [[user|user object]] 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.
 +
 
 +
For an object with a list of user commands, see [[UserList]].
 +
 
 +
== Parameters ==
 +
{{UI Object Parameter (ID)}}
 +
{{UI Object Parameter (image)}}
 +
{{UI Object Parameter (position)}}
 +
*'''size''':the image's width and height
 +
*'''name''': name passed to the Java callback method and event in EVENTS
 +
*'''param''': parameter passed to the Java callback method and event in EVENTS
 +
*'''label''': the text label next to the image. It can contain HTML tags
 +
*'''css''':the label's css attributes
 +
*'''repeat''': if true, the command will be repeat every second
 +
 
 +
== Syntax ==
 +
(userimage[!<id>] <image's filename>; <position>; <width>; <height>; <name>; <param>; <label>; <css>; <repeat>)
 +
E.g.
 +
(userimage!user1 myimage.png; r8c7; 100; 100; name; param; Label; (font-style:italic; top:-15px))
 +
== UI Attributes ==
 +
{{UI Object Attributes (Common)}}
 +
{{UI Object Attributes (Button)}}

Revision as of 15:20, 28 January 2014

Note  For a description and a complete list of UI Objects, see UI Objects.

A clickable image similar to the user object 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.

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

Parameters

  • id: the object's ID, used by UISets
  • image: image filename
  • position: the object's position. Use the pixels or rows and columns coordinates format
  • size:the image's width and height
  • name: name passed to the Java callback method and event in EVENTS
  • param: parameter passed to the Java callback method and event in EVENTS
  • label: the text label next to the image. It can contain HTML tags
  • css:the label's css attributes
  • repeat: if true, the command will be repeat every second

Syntax

(userimage[!<id>] <image's filename>; <position>; <width>; <height>; <name>; <param>; <label>; <css>; <repeat>)

E.g.

(userimage!user1 myimage.png; r8c7; 100; 100; name; param; Label; (font-style:italic; top:-15px)) 

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
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