Creation/Dev/Script/Client/GuiControl: Difference between revisions

From Graal Bible
Line 2: Line 2:


=Variables=
=Variables=
{| border="1" cellpadding="2" width="100%"
{| border="1" cellpadding="2" width="100%"
| '''Name'''
| '''Name'''
Line 22: Line 23:
| boolean
| boolean
|
|
|-
| controls
| object
| array of [[Creation/Dev/Script/Client/GuiControl|GuiControl]] (subcontrols)
|-
|-
| editing
| editing

Revision as of 14:21, 25 February 2006

Inherits from TGraalVar.

Variables

Name Type Description
active boolean
awake boolean (read only)
canmove boolean
canresize boolean
controls object array of GuiControl (subcontrols)
editing boolean
extent string
height integer
hint string
horizsizing string
layer integer (read only)
minextent string
minsize string the same like "minExtent"
parent object (read only)
position string
profile object
resizeheight boolean
resizewidth boolean
scrolllinex integer
scrollliney integer
showhint boolean
useownprofile boolean
vertsizing string
visible boolean
width integer
x integer
y integer

Functions

Name Return Type Description
addcontrol(obj)
bringtofront()
destroy()
getparent() object
globaltolocalcoord(str) string converts global screen coordinates to a position relative to the controls origin (0,0), can be used to know where exactly the user has clicked inside a control
hide() Hide the control
isfirstresponder() boolean Returns whether or not this control is the first responder
localtoglobalcoord(str) string converts a position relative to the controls origin (0,0) to global screen coordinates, can be used to know where on the screen a control is displayed in case it is a child of another control (e.g. GuiWindowCtrl or GuiScrollCtrl)
makefirstresponder(bool)
pushtoback()
resize(int x, int y, int width, int height) Resize the control
show() Show the control
showtop() calls show(), tabfirst() and bringtofront()
tabfirst() object


Events

onAdd() - is invoked when the control is added to another control (addcontrol)

onRemove() - is invoked when the control is removed from its parent

onShow() - is invoked when the control is shown or gets awakened while being 'visible'

onHide() - is invoked when the control is made hidden

onWake() - is invoked when the control is awakened and becomes visible on the screen

onSleep() - is invoked for windows when a dialog window is removed from the screen

onMove(newx,newy) - is invoked when the control is moved

onResize(newwidth,newheight) - is invoked when the control is resized

onAction() - is invoked when a button control is pressed, you press the enter-key in a text edit control, or move a slider control,

onDialogPush() - is invoked when a dialog control is placed on the screen (using pushDialog(control))

onDialogPop() - is invoked when a dialog control is removed from the screen again (using popDialog())

onKeyDown(keycode,keystring,scancode) - a key has been pressed while the control had the input focus (makeFirstResponder())

onKeyUp(keycode,keystring,scancode) - the key has been released

onMouseYawPitch(xaxis,yaxis) - mouse event in Graal3D when the mouse has been turned off

onMouseDown(keymodifier,mousescreenx,mousescreeny,clickcount) - the left mouse button has been pressed inside this control

onMouseUp(keymodifier,mousescreenx,mousescreeny) - the left mouse button has been released

onMouseEnter(keymodifier,mousescreenx,mousescreeny) - the mouse moved inside this control

onMouseLeave(keymodifier,mousescreenx,mousescreeny) - the mouse left the control

onMouseDragged(keymodifier,mousescreenx,mousescreeny) - the mouse is moved while the left mouse button is pressed

onMouseMove(keymodifier,mousescreenx,mousescreeny) - the mouse has been moved

onRightMouseDown(keymodifier,mousescreenx,mousescreeny,clickcount) - the right mouse button has been pressed

onRightMouseUp(keymodifier,mousescreenx,mousescreeny) - the right mouse button has been released

onRightMouseDragged(keymodifier,mousescreenx,mousescreeny) - the mouse has been moved while the right mouse button is pressed

onMouseWheelUp(keymodifier) - the mouse wheel has been scrolled up

onMouseWheelDown(keymodifier) - the mouse wheel has been scrolled down