Button Object
Home ] Up ] General Object Information ] Label Object ] [ Button Object ] Text Object ] Banner Object ] Scrolling Text Object ] List Object ] Drop-Down Object ] Check Box Object ] Plotting Object ] Slider Object ] Bar Object ] Meter and Gauge Objects ] Image Object ] Image Button Object ] Back, Timers and Reset Objects ]

The button object is a standard command button typically used to trigger an event.

Simply drag and drop a button onto an open area of the plot background.

When the button is clicked, a new plot will start (default plot configuration will be loaded, objects are not deleted) and the computer bell will ring.

bulletCreating:
oButton.oBjName=L,T [,W,H,text,font size]
!POBJ oButton.Butn1=5,40
!POBJ oButton.Butn2=5,20,10,10,Click Me!,10
Use no commas in the text string

bulletFunctions:
SET Value (.Set or omitted)
!POBJ objName=text
!POBJ but2=End
Use no commas in the text. 

Clear (.Clear or Clr)
Clears the value
!POBJ objName.Clr 
!POBJ Butn2.Clr

Text Tip (.Tip)
Sets the text pop-up tip
!POBJ objName.Tip=Text string
!POBJ Butn2.Tip=This is a tip!

Font (.Font or .F)
Sets the font of the object
!POBJ objName.Font=[Font name,size,italic (0/1),bold (0/1)]

Move (.Move or .M)

Moves the object to new coordinates/changes sizing
!POBJ objName.Move=[L,T,W,H]   or !POBJ objName.M=[L,T,W,H] 
!POBJ label1.M=50,50,,10

Set Focus (.SF)
Sets the current focus of the application to the object
!POBJ objName.SF
!POBJ butn2.SF
 
bulletUpdate Value (.Update or .U)
Sets the value which will be used to update the object whenever a !POBJ Update is performed.
!POBJ obj.Name.U=[text]
!POBJ Butn2.U=(RTIME)

bulletCode Event - (.C or .Code)
Activated by a click.
objName.Code=string of code.
!POBJ butn2.C=!STAT The date and time is (PRDT)

bulletValues
(objName) - Value of button text.
(objName.T) - Top coordinate
(objName.L) - Left coordinate
(objName.W) - Width
(objName.H) - Height
(objName.B)
- Bottom coordinate
(objName.R) - Right coordinate
(ME) - Used only in its event code, returns object name.
((ME)) - Used only in its event code, returns object value.

bulletSpecial: Using an & before a character in the button text will allow it to be a hot-key:
!POBJ objName=&Click Me
This will underscore the C and using ALT-C will activate the button.

The last button created will be the default button when the carriage return is presses.